Runwayml Gen4 Image Turbo
Playground
Try it on WavespeedAI!RunwayML Gen-4 Image Turbo is cheaper and 2.5x faster than Gen-4 Image and supports up to 3 reference images to capture every angle. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Features
Runway Gen4 Image Turbo
Generate stunning images from text prompts with optional reference image guidance. Runway’s Gen4 Image Turbo delivers fast, high-quality results with support for multiple aspect ratios and resolutions — perfect for rapid creative iteration.
Why It Looks Great
- Reference-guided generation: Upload up to 3 reference images to guide style, composition, or subject appearance.
- Flexible aspect ratios: Supports multiple formats including 9:16, 16:9, 1:1, and more for any use case.
- High resolution output: Generate images up to 1080p for crisp, detailed results.
- Fast turbo processing: Optimized for speed without sacrificing quality.
- Reproducible results: Use the seed parameter to recreate exact outputs or explore variations.
Parameters
| Parameter | Required | Description |
|---|---|---|
| prompt | Yes | Text description of the image you want to generate. |
| aspect_ratio | No | Output aspect ratio (e.g., 9:16, 16:9, 1:1). Default varies. |
| resolution | No | Output resolution (e.g., 1080p). |
| reference_images | No | Up to 3 reference images to guide generation (upload or URL). |
| seed | No | Random seed for reproducibility. Leave empty for random. |
| enable_base64_output | No | API only: Returns base64 string instead of URL. |
How to Use
- Write your prompt — describe the image you want to create in detail.
- Choose aspect ratio — select the format that fits your needs (9:16 for portraits/stories, 16:9 for landscapes, etc.).
- Select resolution — pick your desired output quality.
- Add reference images (optional) — upload up to 3 images to guide style, subject, or composition.
- Set seed (optional) — use a specific number for reproducible results, or leave empty for random.
- Run — click the button to generate.
- Download — preview and save your generated image.
Pricing
Flat rate per image generation.
| Output | Cost |
|---|---|
| Per image | $0.03 |
Examples
| Images Generated | Total Cost |
|---|---|
| 1 | $0.03 |
| 10 | $0.30 |
| 100 | $3.00 |
Best Use Cases
- Social Media Content — Create scroll-stopping visuals for Instagram, TikTok, and stories with 9:16 aspect ratio.
- Concept Art & Ideation — Rapidly explore visual ideas and creative directions.
- Marketing & Advertising — Generate on-brand imagery for campaigns and promotions.
- Character Design — Use reference images to maintain consistent character appearance across generations.
- Style Transfer — Apply the aesthetic of reference images to new scenes and subjects.
Pro Tips for Best Results
- Be specific in your prompts — include details about lighting, mood, style, and composition.
- Use reference images strategically: one for style, one for subject, one for composition.
- Keep the seed fixed when iterating on prompts to isolate the effect of text changes.
- For consistent characters or styles across multiple images, always include the same reference image.
- Match aspect ratio to your intended use case: 9:16 for mobile/stories, 16:9 for desktop/video thumbnails, 1:1 for profile pictures.
Notes
- If using URLs for reference images, ensure they are publicly accessible. A preview thumbnail confirms successful loading.
- The enable_base64_output option is only available through the API, not the web interface.
- Reference images influence but do not guarantee exact replication — they guide style and composition.
Authentication
For authentication details, please refer to the Authentication Guide.
API Endpoints
Submit Task & Query Result
# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/runwayml/gen4-image-turbo" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
"aspect_ratio": "4:3",
"resolution": "1080p",
"enable_base64_output": false
}'
# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"
Parameters
Task Submission Parameters
Request Parameters
| Parameter | Type | Required | Default | Range | Description |
|---|---|---|---|---|---|
| prompt | string | Yes | - | The positive prompt for the generation. | |
| aspect_ratio | string | No | 4:3 | 1:1, 16:9, 9:16, 4:3, 3:4 | The aspect ratio of the generated media. |
| resolution | string | No | 1080p | 1080p, 720p | The resolution of the generated media. |
| reference_images | array | No | - | 1 ~ 3 items | A list of images to use as style references. |
| seed | integer | No | - | -1 ~ 2147483647 | The seed to use for the image generation. |
| enable_base64_output | boolean | No | false | - | If enabled, the output will be encoded into a BASE64 string instead of a URL. This property is only available through the API. |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data.id | string | Unique identifier for the prediction, Task Id |
| data.model | string | Model ID used for the prediction |
| data.outputs | array | Array of URLs to the generated content (empty when status is not completed) |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.has_nsfw_contents | array | Array of boolean values indicating NSFW detection for each output |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |
Result Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| id | string | Yes | - | Task ID |
Result Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data | object | The prediction data object containing all details |
| data.id | string | Unique identifier for the prediction, the ID of the prediction to get |
| data.model | string | Model ID used for the prediction |
| data.outputs | string | Array of URLs to the generated content (empty when status is not completed). |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |