Qwen Video · Video

Reference to VideoNEW

📌 What is this：Use one or more reference images to guide characters, style, or scene before generating video.

💡 When to use：Use when character, product, or style consistency matters.

Endpoints

Usage	Method	Path
Submit task	POST	/api/cqt/generator/qwen
Query Result	GET	/api/cqt/info/qwen?id={taskId}

⏱ Recommended polling interval：Video jobs usually take 1-5 minutes. Poll every 15-20s until status = succeeded / failed.

Request Parameters

Param	Type	Required	Description
model	string	Required	wan2.7-r2v / happyhorse-1.0-r2v / happyhorse-1.1-r2v / wan3.0-video / wan3.0-video-prime (all-in-one: pass reference imageUrls for reference-to-video)
imageUrls	string[]	Required	Reference image URL(s). Note: jpg / png only, no webp. happyhorse accepts 1-9 images; reference the Nth with [Image N] in the prompt
prompt	string	—	Video prompt / guidance instruction
duration	integer	—	Duration in seconds, default 5, affects billing; happyhorse 3-15; wan3.0-video/prime 2-30 (pass -1 for smart duration)
aspectRatio	string	—	Ratio / resolution mapping; happyhorse also supports 4:5 / 5:4 / 9:21 / 21:9
webhookUrl	string	—	Completion webhook URL

Request Example

curl -X POST https://api.cqtai.com/api/cqt/generator/qwen \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "wan2.7-r2v",
    "prompt": "保持参考图角色一致，在城市街头自然行走",
    "imageUrls": ["https://example.com/ref-1.jpg", "https://example.com/ref-2.jpg"],
    "aspectRatio": "16:9",
    "duration": 5
  }'
# -> { "code":200, "data":"<taskId>" }

Response Example

{
  "code": 200,
  "data": {
    "id": "<taskId>",
    "status": "succeeded",
    "resultUrl": "https://.../result.mp4",
    "createTime": "2026-06-15 10:00:00",
    "completeTime": "2026-06-15 10:02:00"
  }
}