Runway REST API

API Endpoints

Code Examples

curl -X POST https://api.runwayml.com/v1/generations/text-to-video \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A serene lake at sunset with mountains in the background",
    "duration": 4,
    "resolution": "1280x768",
    "model": "gen2"
  }'

const response = await fetch('https://api.runwayml.com/v1/generations/text-to-video', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    prompt: 'A serene lake at sunset with mountains in the background',
    duration: 4,
    resolution: '1280x768',
    model: 'gen2'
  })
});

const data = await response.json();
console.log('Generation ID:', data.id);

// Poll for completion
const checkStatus = async (id) => {
  const statusResponse = await fetch(`https://api.runwayml.com/v1/generations/${id}`, {
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
  });
  return await statusResponse.json();
};

import requests
import time

url = 'https://api.runwayml.com/v1/generations/text-to-video'
headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
}
data = {
    'prompt': 'A serene lake at sunset with mountains in the background',
    'duration': 4,
    'resolution': '1280x768',
    'model': 'gen2'
}

response = requests.post(url, headers=headers, json=data)
generation = response.json()
generation_id = generation['id']

# Poll for completion
while True:
    status_response = requests.get(
        f'https://api.runwayml.com/v1/generations/{generation_id}',
        headers=headers
    )
    status = status_response.json()
    if status['status'] == 'completed':
        print(f"Video URL: {status['video_url']}")
        break
    time.sleep(5)

Related APIs