Gen-4 Image Turbo is 2.5x faster and cheaper than Gen-4 Image, with the same reference-driven API: use 1 to 3 reference images with @tag mentions for consistent characters and objects, at a flat price regardless of resolution.
Test this model instantly in the Console Playground โ no code required
Copy usage instructions for Claude, ChatGPT, or other AI
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "runwayml/gen4-image-turbo",
"input": {
"prompt": "a close up portrait of @woman and @man driving fast in a red 1980s sports car",
"resolution": "1080p",
"aspect_ratio": "4:3",
"reference_tags": [
"woman",
"man"
],
"reference_images": [
"https://example.com/woman.jpg",
"https://example.com/man.jpg"
]
}
}'| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
prompt | string | Yes | - | Text prompt for image generation. Reference your images using @tag_name |
seed | integer | No | - | Random seed. Set for reproducible generation |
resolution | string | No | 1080p | Image resolution โ same price at either setting 720p1080p |
aspect_ratio | string | No | 16:9 | Image aspect ratio 16:99:164:33:41:121:9 |
reference_tags | array | No | [] | An optional tag for each reference image, referenced in your prompt as @tag_name. Alphanumeric, starts with a letter, 3-15 characters |
reference_images | array | No | [] | You must give at least one reference image. Up to 3 are supported. Images must be between 0.5 and 2 aspect ratio |
There are 3 ways to provide files for the reference_images parameter:
Attach files directly to POST /v1/predictions/upload. No separate upload step needed.
curl -X POST "https://api.core.today/v1/predictions/upload" \
-H "X-API-Key: cdt_your_api_key" \
-F "model=runwayml/gen4-image-turbo" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:reference_images=@your_file.png"Pass a publicly accessible URL directly. You can also use file_url from the Storage API.
{
"model": "runwayml/gen4-image-turbo",
"input": {
"prompt": "your prompt here",
"reference_images": ["https://example.com/image.jpg"]
}
}Common parameters used when calling POST /v1/predictions.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
model | string | Yes | - | Model identifier |
input | object | Yes | - | Object containing the model-specific parameters from the table above |
output_folder | string | No | - | Folder path for output files (max 256 chars, '..' not allowed) |
webhook_url | string | No | - | Webhook URL to call on completion |
is_public | boolean | No | false | If true, output files are also available via permanent public URLs |
Two reference images bound to @woman and @man tags
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "runwayml/gen4-image-turbo",
"input": {
"prompt": "a close up portrait of @woman and @man driving fast in a red 1980s sports car",
"resolution": "1080p",
"aspect_ratio": "4:3",
"reference_tags": [
"woman",
"man"
],
"reference_images": [
"https://example.com/woman.jpg",
"https://example.com/man.jpg"
]
}
}'POST /v1/predictions