WaveSpeedAI APIRunwaymlRunwayml Gen4 Image

Runwayml Gen4 Image

Runwayml Gen4 Image

Playground

Try it on WavespeedAI!

RunwayML Gen4 Image model lets you generate precise images using up to 3 reference images to capture every angle and detail. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

RunwayML Gen4 Image

RunwayML Gen4 Image is a powerful text-to-image generation model from Runway that creates high-quality images from text descriptions. With optional reference image support, flexible aspect ratios, and resolution choices, it delivers stunning visuals for creative and professional projects.


Why It Stands Out

  • High-quality generation: Produces detailed, visually striking images with excellent composition.
  • Prompt Enhancer: Built-in AI-powered prompt optimization for better image results.
  • Reference image support: Optionally include reference images to guide style or subject consistency.
  • Flexible aspect ratios: Choose from 1:1, 16:9, 9:16, 4:3, or 3:4 to fit any use case.
  • Resolution options: Generate at 720p for speed or 1080p for maximum detail.
  • Reproducibility: Use the seed parameter to recreate exact results.

Parameters

ParameterRequiredDescription
promptYesText description of the image you want to generate.
aspect_ratioNoOutput aspect ratio: 1:1, 16:9, 9:16, 4:3, 3:4 (default: 9:16).
resolutionNoOutput resolution: 720p or 1080p (default: 1080p).
reference_imagesNoOptional reference images to guide style or subject.
seedNoSet for reproducibility; leave empty for random.

Supported Aspect Ratios

Aspect RatioBest For
1:1Instagram posts, social media squares
16:9YouTube thumbnails, widescreen displays
9:16TikTok, Instagram Stories, mobile content
4:3Classic format, presentations
3:4Portrait photos, Pinterest

How to Use

  1. Write a prompt describing the image you want. Use the Prompt Enhancer for AI-assisted optimization.
  2. Select aspect ratio — choose the format that fits your use case.
  3. Choose resolution — select 720p for faster generation or 1080p for higher quality.
  4. Add reference images (optional) — upload images to guide style or subject consistency.
  5. Set a seed (optional) for reproducible results.
  6. Click Run and download your image.

Best Use Cases

  • Creative Art & Illustration — Generate unique artwork and digital illustrations.
  • Social Media Content — Create platform-optimized visuals for any channel.
  • Marketing & Advertising — Produce eye-catching visuals for campaigns.
  • Concept Art — Quickly visualize ideas and creative directions.
  • Style Transfer — Use reference images to maintain consistent aesthetics across projects.

Pricing

ResolutionPrice per image
720p$0.05
1080p$0.08

Pro Tips for Best Quality

  • Be descriptive in your prompt — include style, mood, lighting, composition, and specific details.
  • Use reference images when you need consistent style or subject appearance across multiple generations.
  • Choose 720p for quick drafts and iterations, 1080p for final outputs.
  • Select the appropriate aspect ratio for your intended platform before generating.
  • Fix the seed when iterating to compare different prompt variations.

Notes

  • Ensure uploaded reference image URLs are publicly accessible.
  • Processing time varies based on resolution and current queue load.
  • Please ensure your prompts comply with content guidelines.

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" \
--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

ParameterTypeRequiredDefaultRangeDescription
promptstringYes-The positive prompt for the generation.
aspect_ratiostringNo4:31:1, 16:9, 9:16, 4:3, 3:4The aspect ratio of the generated media.
resolutionstringNo1080p1080p, 720pThe resolution of the generated media.
reference_imagesarrayNo--A list of images to use as style references.
seedintegerNo--1 ~ 2147483647The seed to use for the image generation.
enable_base64_outputbooleanNofalse-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

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
data.idstringUnique identifier for the prediction, Task Id
data.modelstringModel ID used for the prediction
data.outputsarrayArray of URLs to the generated content (empty when status is not completed)
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.has_nsfw_contentsarrayArray of boolean values indicating NSFW detection for each output
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds

Result Request Parameters

ParameterTypeRequiredDefaultDescription
idstringYes-Task ID

Result Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
dataobjectThe prediction data object containing all details
data.idstringUnique identifier for the prediction, the ID of the prediction to get
data.modelstringModel ID used for the prediction
data.outputsstringArray of URLs to the generated content (empty when status is not completed).
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds
© 2025 WaveSpeedAI. All rights reserved.