Skip to main content
GET
Get video job status

Authorizations

Authorization
string
header
required

API key as a bearer token: Authorization: Bearer bpx_live_xxx

Path Parameters

job_id
string
required

The opaque job id returned by the create endpoint.

Response

Current job status. video_url is populated once succeeded.

aspect_ratio
string
completed_at
string<date-time>
created_at
string<date-time>
error_message
string
id
string
length_seconds
integer
model
string
resolution
string

The resolution the job ran at.

started_at
string<date-time>
status
enum<string>

Lifecycle state. succeeded/failed/timeout are terminal.

Available options:
pending,
starting,
processing,
completing,
succeeded,
failed,
timeout
updated_at
string<date-time>
video_codec
enum<string>

Codec of the MP4 at video_url; present once status=succeeded. Most models and resolutions deliver h264. A few high-definition tiers deliver h265 (HEVC, 10-bit) — see resolution_codecs in GET /v1/models.

Available options:
h264,
h265
video_codec_note
string

Present only when video_codec is h265 — a short explanation of where H.265 plays and what to do when it does not.

video_url
string<uri>

Short-lived presigned URL; present once status=succeeded.