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>
draft
boolean

Present, true, on a SeeDance 2.5 draft (made with draft). Its 1080p final is made by sending its id as from_draft_job_id while draft_finalizable is true.

draft_expires_at
string<date-time>

Present on a draft. The last moment its final can be made, 7 days after created_at.

draft_final_credits
integer

Present on a draft. The final's standard price in credits (1080p for the draft's length plus its reference-video seconds), before plan discounts; POST /v1/cost with from_draft_job_id quotes your price.

draft_finalizable
boolean

Present on a draft. true from the moment the draft succeeds until draft_expires_at.

error_message
string
expired
boolean

Present once status=succeeded. true after expires_at; video_url is not returned then.

expires_at
string<date-time>

Present once status=succeeded. When the output is deleted, 24 hours after created_at.

from_draft_job_id
string

Present on a final. The id of the draft it was made from.

id
string

The job id (the same value POST /v1/videos/{model} returned).

job_id
string
deprecated

Same as id; kept for older clients.

length_seconds
integer
model
string
prompt
string

The prompt exactly as you submitted it.

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>

Signed URL, valid at least 6 hours (call this endpoint again for a fresh one); present once status=succeeded, until expired is true.