Video Generations

Submit a video generation task. Video generation is asynchronous: the call returns a task ID that you poll for status, and billing happens when the task completes.

Basics

MethodPOST Endpointhttps://koprouter.kopglobal.com/v1/videos AuthenticationAuthorization: Bearer sk-...

Request Parameters

Parameter Type Required Description
model string Yes Video generation model ID
prompt string Yes Video description
size string No Video resolution
duration number No Video duration

Example Request

curl https://koprouter.kopglobal.com/v1/videos \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "A beach at sunset with waves rolling in",
    "duration": 5
  }'

Example Response

{
  "id": "video-abc123",
  "object": "video",
  "status": "queued"
}

Poll Task Status

Query progress by task ID; status is one of queued, processing, succeeded, or failed:

curl https://koprouter.kopglobal.com/v1/videos/video-abc123 \
  -H "Authorization: Bearer sk-..."
Video is asynchronous and is billed only when the task completes successfully; failed tasks incur no charge.