跳转到主要内容
POST
/
v1
/
tasks
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "action": "generate",
    "prompt": "一只柴犬穿宇航服在月球上行走，电影感光影",
    "aspect_ratio": "16:9",
    "duration": 5,
    "resolution": "1080p",
    "watermark": false,
    "extra": {
      "generate_audio": true
    }
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "seedance-2.0",
  "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": "seedance-2.0",
    "action": "generate",
    "prompt": "一只柴犬穿宇航服在月球上行走，电影感光影",
    "aspect_ratio": "16:9",
    "duration": 5,
    "resolution": "1080p",
    "watermark": false,
    "extra": {
      "generate_audio": true
    }
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "seedance-2.0",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}

​
可用模型

模型 ID说明
seedance-2.0Seedance 2.0，支持原生音频、首尾帧、多模态参考、最高 2K
seedance-2.0-fastSeedance 2.0 快速版
seedance-1.5-proSeedance 1.5 专业版
seedance-1.0-pro-fastSeedance 1.0 快速版
seedance-1.0-pro-qualitySeedance 1.0 高质量版

​
统一参数

​
model
string
必填
模型 ID
​
action
string
默认值:"generate"
操作类型
​
prompt
string
必填
视频描述文本，支持中英文。2.0 支持在 prompt 中用 @image1、@video1、@audio1 引用参考素材
​
aspect_ratio
string
默认值:"16:9"
宽高比：16:9、9:16、4:3、3:4、21:9、1:1
​
duration
integer
默认值:"5"
视频时长（秒），可选范围取决于模型，见各模型 Tab
​
resolution
string
输出分辨率，可选值取决于模型，见各模型 Tab
​
image_urls
string[]
参考图片 URL 数组，数量限制取决于模型版本
​
first_frame
string
首帧图片 URL
​
last_frame
string
尾帧图片 URL（需配合 first_frame）
​
seed
integer
默认值:"-1"
随机种子，范围 [-1, 2^32-1]。-1 为随机。相同种子 + 相同请求可获得相似结果
​
watermark
boolean
默认值:"false"
是否添加水印
​
callback_url
string
Webhook 回调地址
​
extra
object
透传给上游的额外参数，详见各模型 Tab

​
模型特定参数

duration 范围： 4-15 秒resolution 可选值： 480p、720p、1080p、2Ksize 额外支持： adaptive（自适应，匹配输入素材宽高比）输入限制： 图片最多 9 张（≤ 30MB）、视频最多 3 个（≤ 50MB，总时长 ≤ 15s）、音频最多 3 个（MP3/WAV，≤ 15MB，总时长 ≤ 15s）
​
extra.generate_audio
boolean
默认值:"false"
原生音视频联合生成，支持对白口型同步（8+ 语言）
​
extra.return_last_frame
boolean
默认值:"false"
返回末帧图片 URL，便于视频片段衔接续拍
​
extra.tools
array
模型工具，支持联网搜索
"extra": { "tools": [{"type": "web_search"}] }
​
extra.service_tier
string
服务等级，控制延迟与成本的平衡
2.0 使用首尾帧模式（first_frame + last_frame）时，不能同时传 video_urls 和 audio_urls。

​
生成模式

模式参数支持版本
文生视频prompt全部
图生视频prompt + image_urls(1张) 或 first_frame全部
首尾帧first_frame + last_frame1.0-quality / 1.5 / 2.0
多模态参考image_urls + video_urls + audio_urls仅 2.0

​
响应

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