Skip to main content

Runway Gen 4.5 integration

Generate high-quality videos from text prompts or images using Runway’s latest Gen 4.5 model with cinematic quality and precise motion control.
Runway Gen 4.5 is a dual-mode video generation API that creates professional-grade videos from either text descriptions or source images. It delivers cinematic quality with natural motion, supporting durations of 5, 8, or 10 seconds and multiple aspect ratios including landscape (16:9), portrait (9:16), and square (1:1) formats.

​
Key capabilities

  • Text-to-Video (T2V): Generate videos from text descriptions up to 2000 characters
  • Image-to-Video (I2V): Animate source images with motion guided by text prompts
  • Flexible durations: 5, 8, or 10 second video generation (default: 5 seconds)
  • Multiple aspect ratios: 1280:720 (16:9), 720:1280 (9:16), 1104:832 (4:3), 960:960 (1:1), 832:1104 (3:4)
  • Reproducible results: Seed parameter for consistent video generation with identical inputs
  • Async processing: Webhook notifications or polling for task completion

​
Use cases

  • Marketing and advertising: Create product showcase videos and promotional content from concepts
  • Social media content: Generate vertical videos for TikTok, Instagram Reels, and YouTube Shorts
  • E-commerce: Animate product images to create engaging video presentations
  • Creative storytelling: Transform storyboards and illustrations into video sequences
  • Music videos: Generate visual content from artistic concepts and mood descriptions

​
Generate videos with Runway Gen 4.5

Create videos by submitting a text prompt (T2V) or image with prompt (I2V) to the API. The service returns a task ID for async polling or webhook notification.

POST /v1/ai/text-to-video/runway-4-5

Create video from text description

POST /v1/ai/image-to-video/runway-4-5

Create video from source image

GET /v1/ai/text-to-video/runway-4-5

List all text-to-video tasks

GET /v1/ai/image-to-video/runway-4-5

List all image-to-video tasks

GET /v1/ai/text-to-video/runway-4-5/{task-id}

Get T2V task status by ID

GET /v1/ai/image-to-video/runway-4-5/{task-id}

Get I2V task status by ID

​
Text-to-Video Parameters

ParameterTypeRequiredDefaultDescription
promptstringYes-Text description of the video to generate. Maximum 2000 characters.
ratiostringNo1280:720Aspect ratio: 1280:720, 720:1280, 1104:832, 960:960, 832:1104
durationintegerNo5Video duration in seconds: 5, 8, or 10
webhook_urlstringNo-URL for task completion notification

​
Image-to-Video Parameters

ParameterTypeRequiredDefaultDescription
imagestringYes-Source image URL (HTTPS, publicly accessible) or Base64 encoded image
promptstringYes-Text description of the desired motion. Maximum 2000 characters.
ratiostringNo1280:720Aspect ratio: 1280:720, 720:1280, 1104:832, 960:960, 832:1104
durationintegerNo5Video duration in seconds: 5, 8, or 10
seedintegerNo-Random seed for reproducible results (0-4294967295)
webhook_urlstringNo-URL for task completion notification

​
Frequently Asked Questions

Runway Gen 4.5 is an AI video generation model that creates high-quality videos from text prompts (T2V) or source images (I2V). You submit your request via the API, receive a task ID immediately, then poll for results or receive a webhook notification when processing completes. Typical generation takes 30-90 seconds depending on duration.
Text-to-Video (T2V) generates videos entirely from text descriptions, creating both the visual content and motion. Image-to-Video (I2V) takes a source image and animates it based on your text prompt, preserving the original image’s style and subject while adding motion.
Runway Gen 4.5 accepts images via publicly accessible HTTPS URLs or Base64 encoded strings. Common formats like JPEG, PNG, and WebP are supported. Ensure your image URL is accessible without authentication.
Processing time depends on the selected duration and current server load. Typical generation takes 30-90 seconds. Longer durations (10 seconds) may take slightly longer. Use webhooks for production workflows to receive notifications instead of polling.
Runway Gen 4.5 supports five aspect ratios: 1280:720 (16:9 landscape), 720:1280 (9:16 portrait), 1104:832 (4:3 landscape), 960:960 (1:1 square), and 832:1104 (3:4 portrait). The default is 1280:720.
Yes, for Image-to-Video requests. Use the seed parameter with a value between 0 and 4294967295. Using the same seed with identical prompt and image will produce the same video. Note: seed is only available for I2V, not T2V.
Rate limits vary by subscription tier. See Rate Limits for current limits and quotas.
Pricing varies based on video duration and model tier. See the Pricing page for current rates and subscription options.

​
Best practices

  • Prompt clarity: Write detailed, descriptive prompts specifying subject, action, lighting, and style for best results
  • Image quality: For I2V, use high-resolution source images with clear subjects for better animation
  • Aspect ratio matching: Match the aspect ratio to your target platform (9:16 for TikTok/Reels, 16:9 for YouTube)
  • Duration selection: Start with 5 seconds for testing, then increase to 8 or 10 for final production
  • Production integration: Use webhooks instead of polling for scalable applications
  • Error handling: Implement retry logic with exponential backoff for 503 errors during high traffic
  • Runway Gen4 Turbo: Faster video generation with the Gen4 Turbo model
  • Runway Act Two: Character animation and acting performance videos
  • Kling 2.6 Pro: Alternative video generation with advanced motion control
  • WAN 2.6: High-resolution video generation up to 1080p