Endpoint

POST /v1/videos — answers 202 with a job. Poll GET /v1/jobs/{id}, or receive it by webhook, until its state is final.

Dependencies

• first_frame cannot be sent with height, reference_images or width.
• height needs width sent with it.
• last_frame needs first_frame sent with it.
• last_frame cannot be sent with height, reference_images or width.
• resolution needs first_frame or last_frame sent with it.
• resolution cannot be sent with height or width.
• video cannot be sent with height, resolution, seed or width.
• width needs height sent with it.

Request

curl https://api.opinference.com/v1/videos \
  -H "Authorization: Bearer $OP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/veo-3.1",
    "prompt": "a paper boat drifting down a rain gutter"
  }'

Response

The job resource once it has succeeded.

{
  "id": "job_01J9K2…",
  "generation_id": "gen_01J9K2…",
  "object": "job",
  "state": "succeeded",
  "modality": "video",
  "model": "google/veo-3.1",
  "created_at": "2026-09-30T08:00:00Z",
  "started_at": "2026-09-30T08:00:04Z",
  "completed_at": "2026-09-30T08:01:12Z",
  "output": [
    {
      "url": "https://…?X-Amz-Signature=…",
      "url_expires_at": "2026-09-30T09:01:12Z",
      "type": "video/mp4",
      "bytes": 18432011,
      "checksum_sha256": "…"
    }
  ],
  "usage": {
    "units": {
      "video_second": 8
    }
  }
}