Quickstart

1. Create an API key

Go to Account Settings and create a new API key. Copy the secret — it’s only shown once.

2. Generate a video

curl -X POST https://rawugc.com/api/v1/videos/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "RawUGC-Version: 2026-03-06" \
  -d '{
    "model": "sora-2-text-to-video",
    "prompt": "A serene beach at sunset with gentle waves",
    "aspectRatio": "landscape",
    "nFrames": "15"
  }'

const response = await fetch('https://rawugc.com/api/v1/videos/generate', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${YOUR_API_KEY}`,
    'Content-Type': 'application/json',
    'RawUGC-Version': '2026-03-06',
  },
  body: JSON.stringify({
    model: 'sora-2-text-to-video',
    prompt: 'A serene beach at sunset with gentle waves',
    aspectRatio: 'landscape',
    nFrames: '15',
  }),
});

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

import requests

response = requests.post(
    'https://rawugc.com/api/v1/videos/generate',
    headers={
        'Authorization': f'Bearer {YOUR_API_KEY}',
        'Content-Type': 'application/json',
        'RawUGC-Version': '2026-03-06',
    },
    json={
        'model': 'sora-2-text-to-video',
        'prompt': 'A serene beach at sunset with gentle waves',
        'aspectRatio': 'landscape',
        'nFrames': '15',
    }
)

data = response.json()
print('Video ID:', data['videoId'])

The RawUGC-Version header is optional. If omitted, your API key’s pinned version is used, or the latest version (2026-03-06) if unpinned. See Versioning.

You’ll receive a response like:

{
  "videoId": "vid_jh7a3b9xq2pn4r8k",
  "model": "sora-2-text-to-video",
  "status": "pending",
  "creditsUsed": 6,
  "newBalance": 994,
  "estimatedCompletionTime": "1-3 minutes",
  "createdAt": 1234567890000
}

3. Check video status

Poll the status endpoint until the video is ready:

curl https://rawugc.com/api/v1/videos/vid_jh7a3b9xq2pn4r8k \
  -H "Authorization: Bearer YOUR_API_KEY"

const status = await fetch('https://rawugc.com/api/v1/videos/vid_jh7a3b9xq2pn4r8k', {
  headers: { 'Authorization': `Bearer ${YOUR_API_KEY}` },
});
const result = await status.json();

if (result.status === 'completed') {
  console.log('Video URL:', result.url);
}

status = requests.get(
    'https://rawugc.com/api/v1/videos/vid_jh7a3b9xq2pn4r8k',
    headers={'Authorization': f'Bearer {YOUR_API_KEY}'}
)
result = status.json()

if result['status'] == 'completed':
    print('Video URL:', result['url'])

When complete, the response includes the video URL:

{
  "videoId": "vid_jh7a3b9xq2pn4r8k",
  "status": "completed",
  "model": "sora-2-text-to-video",
  "url": "https://storage.rawugc.com/videos/abc123.mp4",
  "creditsUsed": 6,
  "createdAt": 1234567890000,
  "completedAt": 1234567950000
}

Next steps

Available models — explore all 5 AI video models
Authentication — learn about API key management
API Versioning — understand date-based versioning
API Reference — full endpoint documentation

Getting Started

Versioning

Guides

1. Create an API key

2. Generate a video

3. Check video status

Next steps

​1. Create an API key

​2. Generate a video

​3. Check video status

​Next steps

1. Create an API key

2. Generate a video

3. Check video status

Next steps