Get video generation status

Polls a video job. The only terminal states are completed / failed; while running you will usually see pending / processing, but upstream in-flight labels (e.g. in_progress) may pass through — write your loop as "until completed or failed" rather than enumerating intermediate states. Upstream cancellations/expiries (cancelled / expired) surface as failed with the reserved credits refunded. On completed, unsigned_urls lists downloadable content paths and usage.cost is the final charge (billed on actual delivered seconds); on failed, error explains why. Upstream checks are throttled to one per 8s server-side; poll at a ≥5s interval.

GET/api/v1/videos/:id

Authorizations

Authorizationrequired

string · header

API key as bearer token in the Authorization header.

Path parameters

idrequired

string

The job id returned at submit (prefixed vjob_). Only jobs owned by the same account are visible.

Example: "vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk"

Deep guide →

GET /api/v1/videos/:id

1
2
curl https://bazaarlink.ai/api/v1/videos/vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY"

Response examples

Success. The example shows a completed job; pending / processing responses omit unsigned_urls and usage, and failed adds an error field. unsigned_urls are relative paths — GET them with the same API key to download.

1
2
3
4
5
6
7
8
9
10
11
12
{
  "id": "vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk",
  "status": "completed",
  "polling_url": "/api/v1/videos/vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk",
  "unsigned_urls": [
    "/api/v1/videos/vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk/content?index=0"
  ],
  "usage": {
    "cost": 0.5,
    "is_byok": false
  }
}