Hanzo
OpenapiAi

Implements POST /v1/videos/generations — the ASYNC create.

Implements POST /v1/videos/generations — the ASYNC create.

POST /v1/videos/generations

Addresshttps://api.hanzo.ai/v1/videos/generations
MethodPOST
Operationpost_videos_generations
AuthAuthorization: Bearer $HANZO_API_KEY

Implements POST /v1/videos/generations — the ASYNC create.

Body: {"model": "...", "prompt": "...", "size"?: "1280x720", "seconds"?: int}

It authenticates the caller, resolves the model to its upstream provider via the shared routing table (zen3-video* / wan2-2-t2v-a14b → the spark-video backend), reserves the per-video budget (the balance gate), creates ONE upstream job, registers it in the in-pod store, and returns the OpenAI-shaped video object with status "queued" IMMEDIATELY. The client then polls GET /v1/videos/{id} and downloads GET /v1/videos/{id}/content. Nothing is billed here — the debit lands on completion.

Request

The document declares no body for POST /v1/videos/generations. The handler is typed in cloud but its shape is not yet emitted, so the fields are not listed here — ask the MCP door's describe for post_videos_generations, which answers from the running route.

Response

The document declares no response body for this operation. It answers 200 on success and the platform error shape on failure — see Errors.

Examples

hanzo videos generations

AI API · All Hanzo APIs · Interactive reference

How is this guide?

On this page