Create a Gen-4 video
runway_create_gen4Generate a Runway Gen-4 video from a first-frame image asset (required) and an optional prompt, 5 or 10 s, through its own route; the account that holds the image runs it. runway_create_video with model gen4 does the same through the general route that covers every model (prefer it for new work); runway_create_gen4_turbo is the Gen-4 Turbo route. Waits up to ~50 s, then returns the video url and assetId, the failure reason or the taskId for runway_get_task. Uses credits, or none with exploreMode. POST /gen4/create.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"firstImage_assetId": "<firstImage_assetId>"
},
"name": "runway_create_gen4"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seed | No | Seed for reproducible results, 1-4294967294; random when omitted. | |
| wait | No | Wait up to ~50 s for the task to finish (default true); false returns the taskId at once. | |
| seconds | No | Video length in seconds: 5 (default) or 10. | |
| replyRef | No | Your own reference id, stored and returned with the task. | |
| replyUrl | No | A callback URL the API calls with the task (the runway_get_task shape) when it completes or fails. Default: the replyUrl of your useapi.net account. | |
| exploreMode | No | Explore Mode: true spends no credits and runs at lower priority; only for accounts on a Runway Unlimited plan. Omit or false: Credits Mode. | |
| text_prompt | No | Describe the shot (optional). | |
| aspect_ratio | No | Default 16:9. | |
| firstImage_assetId | Yes | firstImage_assetId, the image for the first frame: an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). The task runs on the Runway account that holds the asset. |