Video models
Runway Video Generation
Runway Video Generation — high-quality AI video generation.
| modelId | runway, runway-extend-ai-video |
| Modality | video |
| Pricing | See this model on the Pricing page for the current per-call price (with your markup). |
Operations
| Operation | modelId | Endpoint | Required input |
|---|---|---|---|
| Generate Video | runway | POST /api/v1/generate | prompt, quality |
| Extend Video | runway-extend-ai-video | POST /api/v1/generate | taskId, prompt, quality |
| Poll task | — | GET /api/v1/task/{id}?model=runway | — |
Generate Video — runway
| Field | Type | Required | Values / example |
|---|---|---|---|
| prompt | string | Yes | Descriptive text that guides the AI video generation. Be specific about subject, action, style, and setting. Max 2000 characters. (default: A french bulldog in a tiny raincoat chases soap bubbles across a rainy plaza in slow motion.) |
| imageUrl | string | No | Optional reference image URL. When provided, the AI will animate or extend this image. (image URL) |
| quality | string | Yes | Video resolution. 1080p renders 5-second videos only. (options: 720p | 1080p) (default: 720p) |
| duration | string | Conditional | when `quality` is `720p`: Video duration. At 1080p only 5s is available. (options: 5 | 8 | 10) · when `quality` is `1080p`: Video duration. At 1080p only 5s is available. (options: 5) |
| aspectRatio | string | No | Video aspect ratio. Required for text-to-video; determined by image if imageUrl is provided. (options: 16:9 | 4:3 | 1:1 | 3:4 | 9:16) (default: 16:9) |
| waterMark | string | No | Optional watermark text. Non-empty string displays text in the bottom right corner. Max 100 characters. |
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"runway","input":{"prompt":"A cinematic aerial shot of a coastal town at golden hour, gentle waves rolling onto the shore, warm light, slow camera push-in.","imageUrl":"https://example.com/input.jpg","quality":"720p","duration":"5","aspectRatio":"16:9","waterMark":"example"}}'Extend Video — runway-extend-ai-video
| Field | Type | Required | Values / example |
|---|---|---|---|
| taskId | string | Yes | Unique identifier of the original video generation task. Must be a valid task ID from a previously generated video. Max 50 characters. (default: ee603959-debb-48d1-98c4-a6d1c717eba6) |
| prompt | string | Yes | Descriptive text that guides the continuation of the video. Explain what actions, movements, or developments should happen next. Max 2000 characters. (default: A paper boat drifts down a rain-filled gutter at night, city neon shimmering in the ripples as it spins past fallen leaves; the camera tracks low alongside the water with a shallow depth of field.) |
| quality | string | Yes | Video resolution. Extended videos maintain the same aspect ratio as the original. (options: 720p | 1080p) (default: 720p) |
| waterMark | string | No | Optional watermark text. Non-empty string displays text in the bottom right corner. Max 100 characters. |
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"runway-extend-ai-video","input":{"taskId":"example","prompt":"A cinematic aerial shot of a coastal town at golden hour, gentle waves rolling onto the shore, warm light, slow camera push-in.","quality":"720p","waterMark":"example"}}'