Gen4 Image Turbo | High-Quality Text-to-Image API

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.

Gen4 Image Turbo API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/runwayml/gen4-image-turbo with your input as JSON. The endpoint returns a prediction id. Start polling the result endpoint around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. On completed, read URLs from data.outputs. Examples for Gen4 Image Turbo below.

HTTP example

# Submit the prediction
curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X POST "https://api.wavespeed.ai/api/v3/runwayml/gen4-image-turbo" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "aspect_ratio": "4:3",
    "resolution": "1080p",
    "seed": 0,
    "enable_base64_output": false
}'

# Wait at least 2 seconds, then poll. Safe GET requests may be retried.
curl --fail-with-body --connect-timeout 10 --max-time 30 \
  --retry 4 --retry-all-errors --retry-delay 1 \
  -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY"

# Start at 2 seconds and increase the interval for long-running tasks.
# Stop on completed, failed, cancelled, or timeout.

Node.js example

// npm install wavespeed
const { Client } = require('wavespeed');

const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
const client = new Client(apiKey, {
  maxConnectionRetries: 5,
  retryInterval: 1.0,
});

try {
  const result = await client.run("runwayml/gen4-image-turbo", {
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "aspect_ratio": "4:3",
        "resolution": "1080p",
        "seed": 0,
        "enable_base64_output": false
}, {
    timeout: 3600,
    pollInterval: 2.0,
  });
  console.log(result.outputs);
} catch (error) {
  console.error('Generation failed:', error);
  process.exitCode = 1;
}

Python example

# pip install wavespeed
import os
from wavespeed import Client

client = Client(
    api_key=os.environ["WAVESPEED_API_KEY"],
    max_connection_retries=5,
    retry_interval=1.0,
)

try:
    output = client.run(
        "runwayml/gen4-image-turbo",
        {
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "aspect_ratio": "4:3",
    "resolution": "1080p",
    "seed": 0,
    "enable_base64_output": false
},
        timeout=3600.0,
        poll_interval=2.0,
    )
    print(output["outputs"])
except Exception as error:
    raise SystemExit(f"Generation failed: {error}") from error

Gen4 Image Turbo API — Frequently asked questions

What is the Gen4 Image Turbo API?

Gen4 Image Turbo is a Runwayml model for image generation, exposed as a REST API 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. You can call it programmatically or try it from the playground above.

How do I call the Gen4 Image Turbo API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID. Poll the result endpoint starting around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. The playground generates production-oriented Python, JavaScript, and cURL examples with timeouts, transient-error handling, and safe GET retries. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/runwayml/runwayml-gen4-image-turbo.

How much does Gen4 Image Turbo cost per run?

Gen4 Image Turbo starts at $0.030 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Gen4 Image Turbo accept?

Key inputs: `prompt`, `aspect_ratio`, `resolution`, `seed`, `reference_images`, `enable_base64_output`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/runwayml/runwayml-gen4-image-turbo.

How long does Gen4 Image Turbo take to generate?

Average end-to-end generation time on WaveSpeedAI is around 11 seconds per request — measured across recent runs. Queue time scales with global demand; live status is visible in the prediction record.

Can I use Gen4 Image Turbo outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (Runwayml). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.

Model Terkait

README