Submit Video Generation Task (Unified Format)

Crazyrouter unified video endpoint: a single request body covers every connected video model (veo, Sora, Kling, Jimeng, Doubao Seedance, Hailuo, Tongyi Wanxiang, Grok, etc.); the gateway routes to the corresponding vendor by model and converts the parameters automatically.

POST /v1/video/generations and POST /v1/video/create are fully equivalent (same handler); use either one. Query tasks via GET /v1/video/generations/{task_id}, GET /v1/video/create/{task_id}, or GET /v1/video/query?id=.

Billing: a one-time charge per task is pre-deducted on submission and refunded automatically if the task ultimately fails. Video models can only be called through the video endpoints; calls via /v1/chat/completions and similar endpoints are rejected.

Vendor-specific parameters go in metadata and are passed through as-is, e.g. Kling's {"metadata": {"resolution": "1080p", "camera_control": {...}}}.

Source of truth in code: router/video-router.go (videoV1Router.POST("/video/generations") and POST("/video/create")), controller/relay.go (RelayTask), relay/common/relay_info.go (TaskSubmitReq), relay/channel/task/unified/adaptor.go.

Currently available video models (catalog as of 2026-09-28): aigc-video-gv-3.1 / aigc-video-gv-3.1-fast / aigc-video-gv-3.1-lite (Veo 3.1), aigc-video-kling-1.6 / 2.0 / 2.1 / 2.5-turbo / 2.6 / 3.0 / 3.0-turbo / o1 / avatar / motion-control, doubao-seedance-1-0-lite-t2v / lite-i2v / pro / pro-fast / 1-5-pro / 2-0 / 2-0-fast, hailuo-h3, wan2.2-t2v-plus / i2v-plus / i2v-flash / kf2v-flash / s2v, wan2.5-t2v-preview. The full list is subject to GET /v1/models; aliases such as aigc-video-gv-3.1-fast that are not in the catalog return 404 model_not_found.

Last verified/modified: 2026-09-28 (API Base URL unified to https://api.crazyrouter.com; example model names follow what GET /v1/models returns); tested: missing prompt returns 400 {code:invalid_request,message:prompt is required}; non-video models return 404 {code:model_not_found}; a successful submission returns {id,task_id,object:video,model,status:queued,progress,created_at}

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location 'https://api.crazyrouter.com/v1/video/generations' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "model": "aigc-video-gv-3.1-fast", "prompt": "An astronaut stands up and walks away from the camera, cinematic lighting", "aspect_ratio": "16:9", "seconds": "8", "images": [ "https://media.crazyrouter.com/task-artifacts/tmp-inputs/2026/09/28/user-1/first-frame.png" ] }'

{ "id": "1437730573-AigcVideoTask-5654ea4005cedc749b94a20f1c333bbft", "task_id": "1437730573-AigcVideoTask-5654ea4005cedc749b94a20f1c333bbft", "object": "video", "model": "aigc-video-kling-o1", "status": "queued", "progress": 10, "created_at": 1790584863 }

Submit Video Generation Task (Unified Format)

Request

Responses