Runwayml Gen4 Image

Runwayml Gen4 Image

Playground

Runway’s Gen-4 Image model with references. Use up to 3 reference images to create the exact image you need. Capture every angle.

Features

Overview

Gen-4 Image with references enables generation of consistent characters and locations using 1-3 reference images. The model preserves visual identity while allowing transformation of lighting, poses, settings, and styling through text prompts.

Core Features

• Character preservation: Maintain facial features and identity across different scenes
• Location consistency: Generate multiple angles and shots of the same environment
• Multi-reference support: Use up to 3 reference images per generation
• Conversational prompting: Natural language descriptions with iterative refinement

Optimal reference images

• Natural, even lighting (avoid harsh shadows)
• Neutral expressions for maximum flexibility
• Moderate to high quality
• Clear subject visibility

Usage Patterns

Single Reference

Use text prompts to describe transformations while preserving character identity.

@character_name wearing a leather jacket in a cyberpunk city

Multi-Reference

Combine character and scene references for precise control.

@character sitting in @location with dramatic lighting

Scene Generation

Create consistent environments from different angles.

show the castle courtyard from above
wide shot of the same location at sunset  

Advanced Workflows

• Iterative refinement: Use generated outputs as new references to build complex scenes step-by-step.
• Separate pathways: Develop character and environment references independently, then combine.
• Element isolation: Generate specific clothing, poses, or lighting setups as references for final compositions.

# 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}"