Generate Video
Create a video generation task.
Returns immediately with {"id": "<task_id>"}.
Poll GET /v1/video/generations/{id} until status is
succeeded, failed, or expired.
Pass callback_url to receive a POST notification when the task
status changes. We intercept the provider callback, update our DB,
then forward the full task payload to your URL.
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.