Video models
Runway Video Generation
On this page
Runway Video Generation — high-quality AI video generation.
| modelId | runway |
| Modality | video |
| Pricing | See this model on the Pricing page for the current per-call price (with your markup). |
Operations
| Operation | Endpoint | Description |
|---|---|---|
| Text to video | POST /api/v1/generate | Base generation from a text prompt. |
| Image to video | POST /api/v1/generate | Condition on a reference image — upload it via /api/v1/files/upload and pass the URL. |
| Poll task | GET /api/v1/task/{id}?model=runway | Retrieve state and result URLs. |
Input parameters
| Field | Type | Required | Values / example |
|---|---|---|---|
| prompt | textarea | required | Describe what you want to show in the video... |
| imageUrl | image | optional | Drag and drop or click to upload a reference image |
| duration | select | required | 5, 8, 10 |
| quality | select | required | 720p, 1080p |
| aspectRatio | select | optional | 16:9, 4:3, 1:1, 3:4, 9:16 |
| waterMark | text | optional | Leave blank for no watermark |
Example request
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 french bulldog in a tiny raincoat chases soap bubbles across a rainy plaza in slow motion.","duration":"5","quality":"720p","aspectRatio":"16:9","waterMark":"…"}}'