List video generation jobs

Lists video generation jobs for a specific provider. Results are paginated and can be filtered using query parameters.

GET /v1/videos

Error

A valid request URL is required to generate request examples

200

{
  "object": "list",
  "data": [
    {
      "id": "<string>",
      "object": "video",
      "model": "<string>",
      "progress": 50,
      "prompt": "<string>",
      "remixed_from_video_id": "<string>",
      "seconds": "<string>",
      "size": "<string>",
      "created_at": 123,
      "completed_at": 123,
      "expires_at": 123,
      "error": {
        "code": "<string>",
        "message": "<string>"
      }
    }
  ],
  "first_id": "<string>",
  "last_id": "<string>",
  "has_more": true,
  "extra_fields": {
    "request_type": "<string>",
    "model_requested": "<string>",
    "model_deployment": "<string>",
    "latency": 123,
    "chunk_index": 123,
    "raw_request": {},
    "raw_response": {},
    "cache_debug": {
      "cache_hit": true,
      "cache_id": "<string>",
      "hit_type": "<string>",
      "requested_provider": "<string>",
      "requested_model": "<string>",
      "provider_used": "<string>",
      "model_used": "<string>",
      "input_tokens": 123,
      "threshold": 123,
      "similarity": 123
    }
  }
}

{
  "event_id": "<string>",
  "type": "<string>",
  "is_bifrost_error": true,
  "status_code": 123,
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "event_id": "<string>"
  },
  "extra_fields": {
    "model_requested": "<string>",
    "request_type": "<string>"
  }
}

{
  "event_id": "<string>",
  "type": "<string>",
  "is_bifrost_error": true,
  "status_code": 123,
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "event_id": "<string>"
  },
  "extra_fields": {
    "model_requested": "<string>",
    "request_type": "<string>"
  }
}

Authorizations

BearerAuthBasicAuthVirtualKeyAuthApiKeyAuth

Authorization · string · header · required

Bearer token authentication. Use your provider API key or Bifrost authentication token. Virtual keys (prefixed with sk-bf-) can also be passed here.

Query Parameters

provider · string · required

Provider name (e.g., "openai", "gemini")

after · string

Cursor for pagination - ID of the last item from the previous page

limit · integer · default: 20

Maximum number of results to return

Required range: 1 <= x <= 100

order · enum<string> · default: desc

Sort order by creation time

Available options: asc, desc

Response

200

application/json

Successful response. Returns a paginated list of video generation jobs.

object · enum<string>

Object type, always "list"

Available options: list

data · object[]

Array of video generation jobs

Show child attributes

first_id · string

ID of the first item in the list

last_id · string

ID of the last item in the list

has_more · boolean

Whether there are more results available

extra_fields · object

Additional fields included in responses

Show child attributes