Get Video Generation
Retrieve the status and result of a BytePlus video generation task.
Returns from DB when the task is in a terminal state. Otherwise polls BytePlus live and syncs the DB row.
Poll until status is one of:
succeeded — content.video_url is populated,
failed — check error field,
expired — task timed out.
Version-gated behaviour
video.poll_by_request_id— poll a video task by its MeshAPIrequest_idas well as the provider task id. RequiresX-Mesh-Version: 2026-09or later.
Authorizations
Enter your MeshAPI key (rsk_...) or, for the admin-keys endpoints, a dashboard session token — sent as Authorization: Bearer <token>.
Headers
Dated version of the API contract to pin this request to. Omit it and the request is served under 2026-08 — the oldest supported version, so an existing integration is never moved by a release. A malformed or unsupported value is rejected with 400 invalid_api_version rather than falling back silently. The version actually served is echoed as X-Mesh-Version on every response, including errors.
2026-08, 2026-09 Path Parameters
Response
Task status and result when succeeded