Create Frames images
runway_create_framesGenerate 1 or 4 images at 1080p with Runway Frames from a required prompt, with up to 3 reference image assets cited as @IMG_1, @IMG_2, @IMG_3, a style preset and an aesthetic range (diversity). runway_create_image is the general image tool (13 models); runway_describe_image turns an image into a starting prompt for this one. Waits up to ~50 s, then returns each image's url and assetId plus the first image inline, the failure reason or the taskId for runway_get_task. Uses credits, or none with exploreMode. POST /frames/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": {
"text_prompt": "<text_prompt>"
},
"name": "runway_create_frames"
}
}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. | |
| 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. | ||
| style | No | A style preset. | |
| maxJobs | No | Override the account's maxJobs (Runway tasks at once) for this request, 1-10. Default: the account's own setting. | |
| 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. | |
| diversity | No | Aesthetic range, 0-5: higher varies the images in a set more. With reference images the value is ignored: 2 is always used; without, nothing is sent when omitted (or 0). | |
| num_images | No | Images per task: 1 (default) or 4. | |
| 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 | Yes | What the image shows; cite references as @IMG_1, @IMG_2, @IMG_3. | |
| aspect_ratio | No | Default 16:9. | |
| imageAssetId1 | No | imageAssetId1, reference image 1 (@IMG_1): 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 (@IMG_2): 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 (@IMG_3): 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. |