Video Generation

Submit async video generation jobs via /v1/videos/generations and poll for completion. Routed through Together AI to Sora, Veo, Kling, Wan, Seedream, and Vidu.

Endpoints

POST /v1/videos/generations            # submit job
GET  /v1/videos/generations/{id}       # poll status

Video generation is asynchronous. The submit call returns immediately with a job id and a poll_url; the client polls until status is completed (or failed).

Submit Request

Required Header

Providers

All video models currently route through Together AI (TOGETHER_API_KEY required).

Daily free-tier limits are tight (typically 10–30 requests per model per day). See GET /v1/models for the live enabled list.

Submit Response

Status 202 Accepted when the job is queued, or 200 OK if the provider happens to return a finished job synchronously.

{
  "id": "job_abc123",
  "status": "processing",
  "poll_url": "/v1/videos/generations/job_abc123",
  "x_gateway": {
    "provider": "together",
    "model": "openai/sora-2",
    "attempts": 1,
    "request_id": "req_xyz",
    "project_id": "my_project"
  }
}

Poll Response

{
  "id": "job_abc123",
  "status": "completed",
  "video_url": "https://cdn.example/video.mp4",
  "x_gateway": {
    "provider": "together",
    "model": "openai/sora-2",
    "attempts": 1,
    "request_id": "req_poll1",
    "project_id": "my_project"
  }
}

status is one of "processing", "completed", "failed". When failed, error contains the upstream message.

Examples

Submit

curl https://ai-gateway.sassmaker.com/v1/videos/generations \
  -H "Authorization: Bearer <GATEWAY_API_KEY>" \
  -H "x-gateway-project-id: my_project" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "A slow aerial drone shot over a misty mountain lake at dawn",
    "duration_seconds": 5,
    "aspect_ratio": "16:9"
  }'

const res = await fetch('https://ai-gateway.sassmaker.com/v1/videos/generations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <GATEWAY_API_KEY>',
    'x-gateway-project-id': 'my_project',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'sora-2',
    prompt: 'A slow aerial drone shot over a misty mountain lake at dawn',
    duration_seconds: 5,
    aspect_ratio: '16:9',
  }),
});

const job = await res.json();
console.log('Job ID:', job.id, 'Status:', job.status);

Poll until complete

const BASE = 'https://ai-gateway.sassmaker.com';

async function pollUntilDone(jobId, { interval = 5000, timeout = 300_000 } = {}) {
  const deadline = Date.now() + timeout;
  while (Date.now() < deadline) {
    const res = await fetch(`${BASE}/v1/videos/generations/${jobId}`, {
      headers: { 'Authorization': 'Bearer <GATEWAY_API_KEY>' },
    });
    const body = await res.json();
    if (body.status === 'completed') return body.video_url;
    if (body.status === 'failed') throw new Error(body.error ?? 'job failed');
    await new Promise((r) => setTimeout(r, interval));
  }
  throw new Error('poll timeout');
}

const videoUrl = await pollUntilDone('job_abc123');
console.log(videoUrl);

Image-to-video (Wan)

curl https://ai-gateway.sassmaker.com/v1/videos/generations \
  -H "Authorization: Bearer <GATEWAY_API_KEY>" \
  -H "x-gateway-project-id: my_project" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan-2.2-i2v",
    "prompt": "Camera pans right as clouds roll in",
    "image_url": "https://example.com/source-frame.jpg",
    "duration_seconds": 4
  }'

Error Codes