img_uuid, and resolve the asynchronous result by polling or callback. GoEnhance is a third-party platform and does not claim official affiliation with Runway.Runway API
Access Runway video generation through the independent GoEnhance Open API. Submit a prompt with an optional reference image, save the returned
Create an API Key
Two Runway API Input Modes
Generate Video from a Prompt
Set model to runway and provide the required prompt. For text-to-video, choose a supported duration, resolution, and aspect ratio.
Animate a Reference Image
Add a public image_url to run image-to-video. The output aspect ratio follows the supplied image, so the documented ratio field is ignored.
Validate each request before submitting an asynchronous generation task.
Runway API Capabilities and Parameters
Exact Model ID
Send <code>model: runway</code>. Both <code>model</code> and <code>prompt</code> are required.
Prompt Limit
Describe the video in <code>prompt</code>, with a documented maximum length of 1,800 characters.
Optional Reference Image
Provide a URI in <code>image_url</code> for image-to-video, or omit it for text-to-video.
5s or 10s Duration
Choose <code>duration</code> 5 or 10 seconds. The documented default is 5 seconds, and 1080p supports 5 seconds only.
720p or 1080p
Choose <code>720p</code> or <code>1080p</code>. The documented default is 720p.
Callback Option
Provide a public HTTPS <code>custom_callback_url</code> for processing, success, and failed status notifications.
Pricing is per video. USD equivalents use the documented $0.02 per token.
Runway API Pricing
720p, 5s — 3.9 tokens
GoEnhance lists $0.078 per generated video.
720p, 10s — 9.75 tokens
GoEnhance lists $0.195 per generated video.
1080p, 5s — 9.75 tokens
GoEnhance lists $0.195 per generated video; 1080p does not support 10-second output.
Integrate Runway in Three Steps
1
1. Build and Validate the Request
Create an API key, set
model to runway, add the prompt, and validate duration, resolution, ratio, optional image URL, and callback URL. 2
2. Submit and Save img_uuid
POST the JSON body to
https://api.goenhance.ai/api/v1/videos/generations with bearer authentication. When the response code indicates success, persist data.img_uuid. 3
3. Resolve the Terminal Result
Poll
GET https://api.goenhance.ai/api/v1/jobs/detail?img_uuid=... or process callback events idempotently until the task succeeds or fails.Build workflows around content you own or are authorized to use.
Runway API Use Cases
Ad Concept Variants
Generate short motion concepts from structured campaign prompts and route outputs through editorial review.
Product Image Animation
Use an approved product visual as the reference image for launch, catalog, or social video drafts.
Storyboard Previsualization
Turn shot descriptions into motion studies for camera direction, pacing, and scene planning.
Localized Creative Pipelines
Automate prompt variants, asynchronous task tracking, storage, and review across target markets.
Content Prototyping
Explore scene and motion directions before committing production resources to a finished campaign.
App-Based Video Generation
Connect requests, task IDs, callbacks, asset storage, and human approval inside your application.
Answers about Runway API pricing, inputs, validation, asynchronous delivery, and integration.