跳转到主要内容
POST
/
v1
/
tasks
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hailuo-2.3",
    "action": "generate",
    "prompt": "一只白猫慵懒地躺在阳光下的窗台上",
    "duration": 6,
    "resolution": "1080p"
  }'
{
  "task_id": "task-wave1775285160b950328499",
  "model": "hailuo-2.3",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}
异步处理模式 — 提交请求后返回任务 ID,通过 查询任务状态 接口获取生成结果。视频链接有效期 24 小时。
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hailuo-2.3",
    "action": "generate",
    "prompt": "一只白猫慵懒地躺在阳光下的窗台上",
    "duration": 6,
    "resolution": "1080p"
  }'
{
  "task_id": "task-wave1775285160b950328499",
  "model": "hailuo-2.3",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}

可用模型

模型 ID默认分辨率支持时长说明
hailuo-2.3768P6s / 10s海螺 2.3,支持 4K、角色参考
hailuo-2.3-fast768P6s / 10s海螺 2.3 快速版
hailuo-02768P6s / 10s海螺 02,支持首尾帧
T2V-01-Director768P6s导演模式,支持镜头语法控制
I2V-01-Director720P6s图生视频导演模式
S2V-01720P6s角色参考模式,保持角色一致性

统一参数

model
string
必填
模型 ID
action
string
默认值:"generate"
操作类型
prompt
string
必填
视频描述文本
duration
integer
默认值:"6"
视频时长(秒):610
resolution
string
默认值:"768p"
输出分辨率,可选值取决于模型,见各模型 Tab
image_urls
string[]
首帧图片 URL,用于图生视频
last_frame
string
尾帧图片 URL,需配合 image_urls。仅 hailuo-02 支持
callback_url
string
Webhook 回调地址
extra
object
透传给海螺的额外参数,详见各模型 Tab

模型特定参数

resolution 可选值: 768p1080p
extra.prompt_optimizer
boolean
默认值:"true"
是否启用提示词优化
extra.fast_pretreatment
boolean
快速预处理模式
extra.subject_reference
array
角色参考,保持角色一致性
"extra": {
  "subject_reference": [{
    "type": "character",
    "image": ["https://example.com/character.jpg"]
  }]
}

生成模式

模式参数支持模型
文生视频prompt全部
图生视频prompt + image_urls(1张)全部
首尾帧image_urls(1张) + last_framehailuo-02
角色参考prompt + extra.subject_referencehailuo-2.3 系列

响应

task_id
string
任务 ID
model
string
使用的模型 ID
action
string
操作类型
status
string
任务状态:queued
created_at
integer
创建时间(Unix 毫秒时间戳)
progress
integer
进度,初始为 0