请求

POST /api/v1/video/generate

Headers: X-API-Key: h3k_...

Body:

{
  "prompt": "一只金毛在麦田奔跑",
  "duration": 5,
  "resolution": "480p",
  "model": "t2v"
}

各字段说明：

• model：t2v 是纯文生，r2v 是全能参考，i2v 是首尾帧，enhance 是变清晰。
• resolution：目前对外是 480p 和 768p。768p 更清楚，但生成更慢、更贵。
• duration：视频时长，单位秒。不同分辨率有上限，超了会被拒。
• 如果用到参考素材，先调 /api/v1/upload/presign 上传，拿到 media_id 后在请求里通过 ref_media_ids 传进来。

响应

{
  "task_id": "uuid",
  "status": "queued"
}

返回的是任务 ID，不是视频。视频要等任务完成后通过结果接口拿。

示例

curl -X POST https://api.h3hub.cn/api/v1/video/generate \
  -H "X-API-Key: h3k_xxx" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"一只金毛在麦田奔跑","duration":5,"resolution":"480p"}'

提交成功不代表马上能拿到视频。下一步用 task_id 去轮询 任务状态。