RunwayML 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 futuristic city at sunset with flying cars",
    "model": "gen3",
    "duration": 5,
    "resolution": "1280x768",
    "seed": 42
  }'

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 futuristic city at sunset with flying cars',
    model: 'gen3',
    duration: 5,
    resolution: '1280x768',
    seed: 42
  })
});

const data = await response.json();
const taskId = data.taskId;

// Poll for completion
let result;
do {
  await new Promise(resolve => setTimeout(resolve, 2000));
  const statusResponse = await fetch(`https://api.runwayml.com/v1/generations/${taskId}`, {
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
  });
  result = await statusResponse.json();
} while (result.status !== 'completed');

console.log('Video URL:', result.videoUrl);

import requests
import time

url = 'https://api.runwayml.com/v1/generations/text-to-video'
headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
}
payload = {
    'prompt': 'A futuristic city at sunset with flying cars',
    'model': 'gen3',
    'duration': 5,
    'resolution': '1280x768',
    'seed': 42
}

response = requests.post(url, headers=headers, json=payload)
task_id = response.json()['taskId']

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

Related APIs