Generation is asynchronous. Use the status endpoint to check when your video is ready. Related
Endpoint
GET /api/v1/status/{request_id}
Authentication
Authorization: Bearer sk-your-api-key-here

​
Status responses

Pending
{
  "request_id": "req_abc123...",
  "status": "pending",
  "estimated_cost_usd": 0.25
}
Processing
{
  "request_id": "req_abc123...",
  "status": "processing",
  "estimated_cost_usd": 0.25,
  "progress": 45
}
Completed
{
  "request_id": "req_abc123...",
  "status": "completed",
  "video_url": "https://storage.googleapis.com/vinci-dev/videos/generated_video.mp4",
  "duration_seconds": 5.2,
  "cost_usd": 0.26
}
Failed
{
  "request_id": "req_abc123...",
  "status": "failed",
  "error": "Invalid prompt format"
}

​
Code examples

curl -X GET "https://tryvinci.com/api/v1/status/your-request-id" \
  -H "Authorization: Bearer sk-your-api-key-here"