Create images (all models)
runway_create_imageGenerate images with any of the 13 image models on Runway (FLUX 3, FLUX.2 Max / Klein, Nano Banana / 2 / 2 Lite / Pro, GPT Image 1.5 / 1 Mini / 2, Seedream 5, Gen-4, Gen-4 Turbo) from a prompt and up to 14 reference image assets, 1 or 4 images per task. The general image tool; runway_create_frames is the older Frames route (1080p, up to 3 references). 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 (not flux-3). POST /images/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_image"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seed | No | gen4, gen4-turbo, flux-2-max and flux-2-klein only: seed, 1-4294967294. | |
| 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. | ||
| model | Yes | The image model. References and prompt limits: flux-3 (0-10 refs, prompt required, 4000, one image), flux-2-max (0-8) / flux-2-klein (0-4, prompt 4000, cite refs as "image 1"), nano-banana (0-3), nano-banana-2, nano-banana-2-lite, nano-banana-pro (0-14; prompt 5000), gpt-image-1-5, gpt-image-1-mini (0-1), gpt-image-2 (0-14; prompt required, 32000), seedream-5 (0-14, 4000), gen4 (0-3), gen4-turbo (1-3 required; prompt 1000). | |
| style | No | gen4 and gen4-turbo only: 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. | |
| quality | No | gpt-image-2 only: low, medium or high (default). | |
| 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 | gen4 only: aesthetic range, 1-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. | |
| num_images | No | Images per task: 1 (default) or 4; flux-3 makes 1. | |
| resolution | No | Per model: flux-3 1K (default), 2K, 4K, 0.5K, 0.75K; flux-2-max 1K (default), 2K, 4K, 0.6MP; flux-2-klein 1K (default), 2K, 0.6MP; gpt-image-2, nano-banana-2, nano-banana-pro 1K (default), 2K, 4K; seedream-5 2K (default), 3K; gen4 1080p (default), 720p; gen4-turbo 1080p. Not taken by nano-banana, nano-banana-2-lite, gpt-image-1-5, gpt-image-1-mini. | |
| exploreMode | No | Explore Mode: true spends no credits and runs at lower priority; only for accounts on a Runway Unlimited plan; not on flux-3. Omit or false: Credits Mode. | |
| text_prompt | No | What the image shows. Required by flux-3, gpt-image-1-5, gpt-image-1-mini and gpt-image-2. Max length per model under model. On gen4, seedream-5 and Nano Banana models @IMG_1, @IMG_2 cite the reference images. | |
| aspect_ratio | No | Image shape. Default auto (the model picks) on nano-banana, nano-banana-pro, nano-banana-2, nano-banana-2-lite, flux-3, else 16:9. gpt-image-1-5, gpt-image-1-mini do not take 16:9 (1:1, 3:2, 2:3 only): always set aspect_ratio there; seedream-5: no 4:5, 5:4, 9:21; Nano Banana: no 9:21; 2:1, 1:2, 7:5, 5:7 flux-3 only. | |
| imageAssetId1 | No | imageAssetId1, reference image 1 (fill slots in order; the count per model is under model): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). | |
| imageAssetId2 | No | imageAssetId2, reference image 2 (fill slots in order; the count per model is under model): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). | |
| imageAssetId3 | No | imageAssetId3, reference image 3 (fill slots in order; the count per model is under model): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). | |
| imageAssetId4 | No | imageAssetId4, reference image 4 (fill slots in order; the count per model is under model): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). | |
| imageAssetId5 | No | imageAssetId5, reference image 5 (fill slots in order; the count per model is under model): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). | |
| imageAssetId6 | No | imageAssetId6, reference image 6 (fill slots in order; the count per model is under model): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). | |
| imageAssetId7 | No | imageAssetId7, reference image 7 (fill slots in order; the count per model is under model): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). | |
| imageAssetId8 | No | imageAssetId8, reference image 8 (fill slots in order; the count per model is under model): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). | |
| imageAssetId9 | No | imageAssetId9, reference image 9 (fill slots in order; the count per model is under model): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). | |
| imageAssetId10 | No | imageAssetId10, reference image 10 (fill slots in order; the count per model is under model): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). | |
| imageAssetId11 | No | imageAssetId11, reference image 11 (fill slots in order; the count per model is under model): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). | |
| imageAssetId12 | No | imageAssetId12, reference image 12 (fill slots in order; the count per model is under model): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). | |
| imageAssetId13 | No | imageAssetId13, reference image 13 (fill slots in order; the count per model is under model): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). | |
| imageAssetId14 | No | imageAssetId14, reference image 14 (fill slots in order; the count per model is under model): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). |