Text-to-video
Create a video from a text prompt.
Accepts the full video parameter set; send a text prompt in content.
Returns immediately with {"id": "<task_id>"}; poll
GET /v1/video/generations/{id} for status.
Authorizations
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, 2026-11, 2026-11-12 Body
Response
Task created; poll the returned id for status
The submit response, which carries one field retrieval cannot.
[internal]. unsupported_params is the parameters the caller sent that the
SERVED provider drops — knowable only at submit, and reconstructing it on a
later read would mean persisting it per task. It is on a subclass rather than
on VideoTaskResponse because that model is also what the poll and list
paths return AND what upstream payloads are parsed into, so a field there
would appear as a null on responses that can never populate it.
Null (not absent) when nothing was dropped, like every other optional field.