Skip to main content
GET
/
videos
/
{id}
Get a video job
curl --request GET \
  --url http://localhost:3001/api/v1/videos/{id} \
  --header 'x-api-key: <api-key>'
{
  "data": {
    "id": "6b2c1d4e-9a8f-4c3b-bd21-0e7f3a2c5d19",
    "type": "video.generate",
    "status": "completed",
    "createdAt": "2026-06-16T10:00:00.000Z",
    "result": {
      "video": {
        "id": "6b2c1d4e-9a8f-4c3b-bd21-0e7f3a2c5d19",
        "url": "https://cdn.example.com/assets/u_123/6b2c1d4e/original.mp4",
        "durationSeconds": 6,
        "thumbnailUrl": "https://cdn.example.com/assets/u_123/6b2c1d4e/thumbnail.jpg",
        "width": 1280,
        "height": 720
      }
    }
  }
}

Authorizations

x-api-key
string
header
required

Path Parameters

id
string<uuid>
required

Query Parameters

wait
enum<string>

When true, hold the connection until the job is terminal (up to ~55s), then return its current state. On timeout the job may still be pending/processing; re-issue the request to keep waiting.

Available options:
true

Response

OK

data
object
required