Skip to main content
POST
Runway Gen-4 Turbo
$0.05 per output second.

Authorizations

Authorization
string
header
required

API Key for API endpoints

Body

first_frame_url
string<uri>
required

Initial image for video generation (first frame)

prompt
string
required

Text prompt for video generation

seed
integer | null

Random seed. Set for reproducible generation

Required range: -9007199254740991 <= x <= 9007199254740991
duration
default:5

Duration of output video in seconds

aspect_ratio
enum<string>
default:16:9

Video aspect ratio

Available options:
16:9,
9:16,
4:3,
3:4,
1:1,
21:9
n
integer
default:1

Number of results to generate (1-4)

Required range: 1 <= x <= 4

Response

Generation submission accepted

id
string
required

Generation id.

status
enum<string>
required

Queue status

Available options:
IN_QUEUE,
IN_PROGRESS,
COMPLETED,
FAILED,
CANCELED
input
Input · object
required

Normalized input payload for the generation task.

usage
object
required

Credit usage breakdown for the request

code
string

Machine-readable generation error code. Present when status is FAILED.

message
string

Sanitized human-readable failure message. Present when status is FAILED.