Create a video (all models)
runway_create_videoGenerate a video with any of the 25 video models on Runway (Seedance 2.5 / 2.0, Wan 3.0, MiniMax H3, FLUX 3, Grok Imagine 1.5, HappyHorse, Kling O3 / 3.0 / 2.6, Veo 3.1, Gen-4.5, Gen-4, Gen-4 Turbo) from a prompt and optional reference assets (images, videos, audio from runway_upload_asset). The general video tool: runway_create_gen4_5, runway_create_gen4 and runway_create_gen4_turbo are older single-model routes; runway_edit_video_aleph, runway_act_two and runway_lipsync cover video-to-video, performance and lip sync. Waits up to ~50 s, then returns the video url and assetId (SUCCEEDED), the reason (FAILED) or the taskId for runway_get_task. Uses the account's credits, or none with exploreMode. POST /videos/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": {
"model": "<model>"
},
"name": "runway_create_video"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seed | No | Seed, 1-4294967294: gen4.5, gen4, gen4-turbo and minimax-h3-max only (random when omitted). | |
| wait | No | Wait up to ~50 s for the task to finish (default true); false returns the taskId at once. | |
| audio | No | Generate sound (default true); false for a silent video. On kling-3.0-motion-control and kling-o3-* Edit Video it keeps or drops the source video's sound. Ignored by grok-imagine-1.5 (always silent); no effect on minimax-h3 and minimax-h3-max (no audio toggle). | |
| draft | No | seedance-2-5 only: true renders a cheaper 480p preview at the 480p rate (resolution 480p, no mov). Runway offers drafts to some accounts only. | |
| No | The Runway account to run it on: its email from runway_list_accounts. Omit it with reference assets (the account that holds them runs the task) or to let the API pick one of your accounts. | ||
| model | Yes | The video model. Seedance: seedance-2-5 (4-30 s or 0 = Auto, up to 30 image / 10 video / 10 audio references, video_mode, drafts), seedance-2, seedance-2-fast, seedance-2-mini (4-15 s). Wan: wan-3.0, wan-3.0-prime (2-30 s or 0 = Auto), wan-2.6-flash (5 / 10 / 15 s, one image), wan-2.2-animate (one image + videoAssetId, no prompt). minimax-h3, minimax-h3-max (5-15 s). flux-3 (5-20 s or 0 = Auto, can extend a video). grok-imagine-1.5 (3-15 s, image-to-video only, silent). happyhorse-1.0 (3-15 s). Kling: kling-o3-4k, kling-o3-pro, kling-o3-standard (5 / 10 / 15 s, multishot, Edit Video on pro / standard), kling-3.0-pro, kling-3.0-standard (5 / 10 / 15 s, multishot), kling-3.0-motion-control (character image + performance video), kling-2.6-pro, kling-2.6-i2v (5 / 10 s). veo-3.1 (4 / 6 / 8 s). Runway: gen4.5 (2-10 s), gen4, gen4-turbo (5 / 10 s, one image required). | |
| maxJobs | No | Override the account's maxJobs (Runway tasks at once) for this request, 1-10. Default: the account's own setting. | |
| duration | No | Length in seconds, per model as listed under model; 0 = Auto (the model picks the length) on seedance-2-5, wan-3.0 / -prime (billed up to 30 s, the rest refunded) and flux-3 (billed up to 20 s). Default: the model's first value, 5 on wan-3.0 / -prime and flux-3. Not taken by kling-3.0-motion-control and wan-2.2-animate (from the reference video). | |
| 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. | |
| resolution | No | Output resolution, per model: seedance-2-5 720p (default), 480p, 1080p (some accounts only, not in Explore Mode); seedance-2 / -fast 480p (default), 720p, 1080p (not in Explore Mode); seedance-2-mini 720p (default), 480p; wan-3.0 / -prime 1080p (default), 720p, 480p; minimax-h3 2K (default), 768p; minimax-h3-max 768p (default), 480p; flux-3, happyhorse-1.0, wan-2.6-flash, veo-3.1 720p (default), 1080p; grok-imagine-1.5 480p (default), 720p; kling-3.0-motion-control 720p (default), 1080p; gen4 / gen4-turbo 720p. Other models pick it themselves. | |
| video_mode | No | seedance-2-5 only, Edit Video on the video in videoAssetId (up to 31 s; all reference videos together up to 30 s), text_prompt required, aspect_ratio not used: edit changes it as the prompt says (output as long as the source, not in Explore Mode); extend continues it forwards or backwards for duration seconds (default 5). | |
| draftTaskId | No | seedance-2-5 only: the taskId of a draft to re-render at 1080p within 7 days of the draft, at the 1080p rate. Takes only model, email, maxJobs, replyUrl and replyRef; not in Explore Mode. | |
| exploreMode | No | Explore Mode: true spends no credits and runs at lower priority; only for accounts on a Runway Unlimited plan; not on veo-3.1, wan-3.0, wan-3.0-prime, minimax-h3, minimax-h3-max and flux-3. Seedance 1080p needs Credits Mode; seedance-2-5 in Explore Mode is capped at 15 s, with no Auto duration, no video_mode edit and reference videos up to 15 s together. Omit or false: Credits Mode. | |
| text_prompt | No | What the video shows. Required by wan-3.0, wan-3.0-prime, minimax-h3, minimax-h3-max, flux-3, gen4, gen4-turbo, kling-2.6-pro, kling-2.6-i2v and wan-2.6-flash; not taken by wan-2.2-animate; optional elsewhere. Max length per model: 20000 wan-3.0 / -prime, 15000 seedance-2-5, 6000 minimax-h3 / -max, 5000 gen4.5, veo-3.1 and flux-3, 3500 seedance-2 / -fast / -mini, 2500 Kling, grok-imagine-1.5 and happyhorse-1.0, 1500 wan-2.6-flash, 1000 gen4 / gen4-turbo. On kling-o3-* @IMG_1..@IMG_7 cite imageAssetId1..7. | |
| aspect_ratio | No | Frame shape; the values depend on the model (gen4.5 text-to-video is 16:9 only; kling-o3-* and kling-3.0-pro / -standard 16:9, 9:16, 1:1; kling-2.6-pro and veo-3.1 16:9, 9:16). auto lets the model choose on seedance-2-5, wan-3.0 / -prime, minimax-h3 and flux-3 (the default on all but seedance-2-5); 2:1 on flux-3 only. Not taken by kling-2.6-i2v, kling-3.0-motion-control, minimax-h3-max. | |
| videoAssetId | No | videoAssetId, reference video 1: required by wan-2.2-animate and kling-3.0-motion-control (performance, 3-30 s); the source for Edit Video on kling-o3-pro / -standard (up to 10 s) and seedance-2-5 video_mode (up to 31 s); the clip to extend on flux-3 (up to 15 s, not with startFrameAssetId); a reference on Seedance, wan-3.0 and minimax-h3: 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. | |
| audioAssetId1 | No | audioAssetId1, reference audio 1 (MP3, WAV or M4A; fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2, seedance-2-fast, seedance-2-mini, seedance-2-5, wan-3.0, wan-3.0-prime, minimax-h3; not with startFrameAssetId / endFrameAssetId. | |
| audioAssetId2 | No | audioAssetId2, reference audio 2 (MP3, WAV or M4A; fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2, seedance-2-fast, seedance-2-mini, seedance-2-5, wan-3.0, wan-3.0-prime, minimax-h3; not with startFrameAssetId / endFrameAssetId. | |
| audioAssetId3 | No | audioAssetId3, reference audio 3 (MP3, WAV or M4A; fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2, seedance-2-fast, seedance-2-mini, seedance-2-5, wan-3.0, wan-3.0-prime, minimax-h3; not with startFrameAssetId / endFrameAssetId. | |
| audioAssetId4 | No | audioAssetId4, reference audio 4 (MP3, WAV or M4A; fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5, wan-3.0, wan-3.0-prime; not with startFrameAssetId / endFrameAssetId. | |
| audioAssetId5 | No | audioAssetId5, reference audio 5 (MP3, WAV or M4A; fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5, wan-3.0, wan-3.0-prime; not with startFrameAssetId / endFrameAssetId. | |
| audioAssetId6 | No | audioAssetId6, reference audio 6 (MP3, WAV or M4A; fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5; not with startFrameAssetId / endFrameAssetId. | |
| audioAssetId7 | No | audioAssetId7, reference audio 7 (MP3, WAV or M4A; fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5; not with startFrameAssetId / endFrameAssetId. | |
| audioAssetId8 | No | audioAssetId8, reference audio 8 (MP3, WAV or M4A; fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5; not with startFrameAssetId / endFrameAssetId. | |
| audioAssetId9 | No | audioAssetId9, reference audio 9 (MP3, WAV or M4A; fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5; not with startFrameAssetId / endFrameAssetId. | |
| imageAssetId1 | No | imageAssetId1, reference image 1 (start frame on most models). Required by gen4, gen4-turbo, kling-2.6-i2v, wan-2.6-flash, wan-2.2-animate, grok-imagine-1.5 and kling-3.0-motion-control (the character to animate): 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. | |
| imageAssetId2 | No | imageAssetId2, reference image 2: the end frame on kling-3.0-pro / -standard and veo-3.1, a further reference on multi-reference models: 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. | |
| imageAssetId3 | No | imageAssetId3, reference image 3 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by kling-o3-4k, kling-o3-pro, kling-o3-standard, seedance-2, seedance-2-fast, seedance-2-mini, seedance-2-5, wan-3.0, wan-3.0-prime, minimax-h3. | |
| imageAssetId4 | No | imageAssetId4, reference image 4 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by kling-o3-4k, kling-o3-pro, kling-o3-standard, seedance-2, seedance-2-fast, seedance-2-mini, seedance-2-5, wan-3.0, wan-3.0-prime, minimax-h3. | |
| imageAssetId5 | No | imageAssetId5, reference image 5 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by kling-o3-4k, kling-o3-pro, kling-o3-standard, seedance-2, seedance-2-fast, seedance-2-mini, seedance-2-5, wan-3.0, wan-3.0-prime, minimax-h3. | |
| imageAssetId6 | No | imageAssetId6, reference image 6 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by kling-o3-4k, kling-o3-pro, kling-o3-standard, seedance-2, seedance-2-fast, seedance-2-mini, seedance-2-5, wan-3.0, wan-3.0-prime, minimax-h3. | |
| imageAssetId7 | No | imageAssetId7, reference image 7 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by kling-o3-4k, kling-o3-pro, kling-o3-standard, seedance-2, seedance-2-fast, seedance-2-mini, seedance-2-5, wan-3.0, wan-3.0-prime, minimax-h3. | |
| imageAssetId8 | No | imageAssetId8, reference image 8 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2, seedance-2-fast, seedance-2-mini, seedance-2-5, wan-3.0, wan-3.0-prime, minimax-h3. | |
| imageAssetId9 | No | imageAssetId9, reference image 9 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2, seedance-2-fast, seedance-2-mini, seedance-2-5, wan-3.0, wan-3.0-prime, minimax-h3. | |
| output_format | No | seedance-2-5 only: the container, mp4 (default) or mov. | |
| videoAssetId2 | No | videoAssetId2, reference video 2 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2, seedance-2-fast, seedance-2-mini, seedance-2-5, wan-3.0, wan-3.0-prime, minimax-h3. | |
| videoAssetId3 | No | videoAssetId3, reference video 3 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2, seedance-2-fast, seedance-2-mini, seedance-2-5, wan-3.0, wan-3.0-prime, minimax-h3. | |
| videoAssetId4 | No | videoAssetId4, reference video 4 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5, wan-3.0, wan-3.0-prime. | |
| videoAssetId5 | No | videoAssetId5, reference video 5 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5, wan-3.0, wan-3.0-prime. | |
| videoAssetId6 | No | videoAssetId6, reference video 6 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5. | |
| videoAssetId7 | No | videoAssetId7, reference video 7 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5. | |
| videoAssetId8 | No | videoAssetId8, reference video 8 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5. | |
| videoAssetId9 | No | videoAssetId9, reference video 9 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5. | |
| audioAssetId10 | No | audioAssetId10, reference audio 10 (MP3, WAV or M4A; fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5; not with startFrameAssetId / endFrameAssetId. | |
| imageAssetId10 | No | imageAssetId10, reference image 10 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5, wan-3.0, wan-3.0-prime. | |
| imageAssetId11 | No | imageAssetId11, reference image 11 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5. | |
| imageAssetId12 | No | imageAssetId12, reference image 12 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5. | |
| imageAssetId13 | No | imageAssetId13, reference image 13 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5. | |
| imageAssetId14 | No | imageAssetId14, reference image 14 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5. | |
| imageAssetId15 | No | imageAssetId15, reference image 15 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5. | |
| imageAssetId16 | No | imageAssetId16, reference image 16 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5. | |
| imageAssetId17 | No | imageAssetId17, reference image 17 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5. | |
| imageAssetId18 | No | imageAssetId18, reference image 18 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5. | |
| imageAssetId19 | No | imageAssetId19, reference image 19 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5. | |
| imageAssetId20 | No | imageAssetId20, reference image 20 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5. | |
| imageAssetId21 | No | imageAssetId21, reference image 21 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5. | |
| imageAssetId22 | No | imageAssetId22, reference image 22 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5. | |
| imageAssetId23 | No | imageAssetId23, reference image 23 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5. | |
| imageAssetId24 | No | imageAssetId24, reference image 24 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5. | |
| imageAssetId25 | No | imageAssetId25, reference image 25 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5. | |
| imageAssetId26 | No | imageAssetId26, reference image 26 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5. | |
| imageAssetId27 | No | imageAssetId27, reference image 27 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5. | |
| imageAssetId28 | No | imageAssetId28, reference image 28 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5. | |
| imageAssetId29 | No | imageAssetId29, reference image 29 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5. | |
| imageAssetId30 | No | imageAssetId30, reference image 30 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5. | |
| videoAssetId10 | No | videoAssetId10, reference video 10 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5. | |
| endFrameAssetId | No | endFrameAssetId, the last frame; needs startFrameAssetId. Same models as startFrameAssetId except flux-3; on kling-o3-* not with reference images: 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. | |
| prompt_expansion | No | minimax-h3-max only: how the model rewrites the prompt first; Runway uses balanced when omitted. | |
| startFrameAssetId | No | startFrameAssetId, the first frame (keyframe mode) on Seedance, wan-3.0 / -prime, minimax-h3, minimax-h3-max (256 px or more per side), flux-3 and kling-o3-*. Not with multi-reference images, videos or audio on Seedance, wan-3.0 and minimax-h3: 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. | |
| multishot_prompt_1 | No | The prompt of shot 1 in a multi-shot video (kling-3.0-pro, kling-3.0-standard, kling-o3-4k, kling-o3-pro, kling-o3-standard); needs multishot_duration_1. Shots are numbered from 1 without gaps, at least 2. On kling-o3-* @IMG_N in a shot's prompt binds imageAssetIdN to that shot. | |
| multishot_prompt_2 | No | The prompt of shot 2 in a multi-shot video (kling-3.0-pro, kling-3.0-standard, kling-o3-4k, kling-o3-pro, kling-o3-standard); needs multishot_duration_2. Shots are numbered from 1 without gaps, at least 2. On kling-o3-* @IMG_N in a shot's prompt binds imageAssetIdN to that shot. | |
| multishot_prompt_3 | No | The prompt of shot 3 in a multi-shot video (kling-3.0-pro, kling-3.0-standard, kling-o3-4k, kling-o3-pro, kling-o3-standard); needs multishot_duration_3. Shots are numbered from 1 without gaps, at least 2. On kling-o3-* @IMG_N in a shot's prompt binds imageAssetIdN to that shot. | |
| multishot_prompt_4 | No | The prompt of shot 4 in a multi-shot video (kling-3.0-pro, kling-3.0-standard, kling-o3-4k, kling-o3-pro, kling-o3-standard); needs multishot_duration_4. Shots are numbered from 1 without gaps, at least 2. On kling-o3-* @IMG_N in a shot's prompt binds imageAssetIdN to that shot. | |
| multishot_prompt_5 | No | The prompt of shot 5 in a multi-shot video (kling-3.0-pro, kling-3.0-standard, kling-o3-4k, kling-o3-pro, kling-o3-standard); needs multishot_duration_5. Shots are numbered from 1 without gaps, at least 2. On kling-o3-* @IMG_N in a shot's prompt binds imageAssetIdN to that shot. | |
| multishot_prompt_6 | No | The prompt of shot 6 in a multi-shot video (kling-o3-4k, kling-o3-pro, kling-o3-standard); needs multishot_duration_6. Shots are numbered from 1 without gaps, at least 2. On kling-o3-* @IMG_N in a shot's prompt binds imageAssetIdN to that shot. | |
| characterOrientation | No | kling-3.0-motion-control only: follow the character's orientation in the image (default) or in the performance video. | |
| multishot_duration_1 | No | Shot 1 length in seconds, 3-12; all shots together at most 15 s. | |
| multishot_duration_2 | No | Shot 2 length in seconds, 3-12; all shots together at most 15 s. | |
| multishot_duration_3 | No | Shot 3 length in seconds, 3-12; all shots together at most 15 s. | |
| multishot_duration_4 | No | Shot 4 length in seconds, 3-12; all shots together at most 15 s. | |
| multishot_duration_5 | No | Shot 5 length in seconds, 3-12; all shots together at most 15 s. | |
| multishot_duration_6 | No | Shot 6 length in seconds, 3-12; all shots together at most 15 s. |