Skip to main content

​
Runway

POST /runwayml/v1/image_to_video
Use the Runway Gen-3 model to convert images into videos.

​
Request Parameters

ParameterTypeRequiredDescription
modelstringNoModel name, e.g. gen3a_turbo
promptImagestringYesInput image URL
promptTextstringNoVideo description prompt
durationintegerNoVideo duration (seconds), default 5
ratiostringNoAspect ratio: 16:9, 9:16
watermarkbooleanNoWhether to add a watermark

​
Request Examples

curl -X POST https://crazyrouter.com/runwayml/v1/image_to_video \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gen3a_turbo",
    "promptImage": "https://example.com/landscape.jpg",
    "promptText": "Camera slowly pans across the landscape, clouds moving in the sky",
    "duration": 5,
    "ratio": "16:9",
    "watermark": false
  }'

​
Response Example

{
  "id": "runway_task_abc123",
  "status": "PENDING"
}

​
Query Task

GET /runwayml/v1/tasks/{task_id}
cURL
curl https://crazyrouter.com/runwayml/v1/tasks/runway_task_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response Example (Completed)

{
  "id": "runway_task_abc123",
  "status": "SUCCEEDED",
  "output": [
    "https://runway-output.s3.amazonaws.com/..."
  ]
}

​
Task Status

StatusDescription
PENDINGWaiting to be processed
RUNNINGGenerating
SUCCEEDEDSucceeded
FAILEDFailed