立即注册

火山方舟视频 · 平台异步任务

火山方舟视频 · 平台异步任务 API（推荐）

适用 modelKey：

doubao-seedance-1.5-pro、doubao-seedance-1.0-pro、doubao-seedance-1.0-pro-fast、doubao-seedance-2.0、doubao-seedance-2.0-fast

完整列表见 modelKey 速查表。

文生视频

export API_KEY="uas_你的密钥"
export API_BASE_URL="https://aiservice.jellytoken.com"

TASK=$(curl -s -X POST "$API_BASE_URL/api/ai/tasks" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "modelKey": "doubao-seedance-2.0",
    "callbackId": "seedance-001",
    "videoParams": {
      "prompt": "无人机掠过雪山，电影感航拍",
      "duration": 5,
      "resolution": "720p",
      "aspectRatio": "16:9"
    }
  }')
echo "$TASK"

TASK_ID=$(echo "$TASK" | jq -r .taskId)
curl -s "$API_BASE_URL/api/ai/tasks/$TASK_ID" \
  -H "Authorization: Bearer $API_KEY" | jq .

status=completed 时从 resultUrlPublic 取视频地址。建议每 2~5 秒轮询，或使用 Webhook 回调。

图生视频

{
  "modelKey": "doubao-seedance-1.5-pro",
  "videoParams": {
    "prompt": "镜头推进",
    "firstFrame": "https://example.com/start.jpg",
    "duration": 5
  }
}

平台入参

字段必填说明
modelKey是Seedance 系列 modelKey
callbackId建议幂等 ID
callbackUrl否Webhook 地址
requestContext否透传键值
videoParams.prompt建议提示词
videoParams.firstFrame / lastFrame否首尾帧 URL
videoParams.refImages否参考图 URL 数组
videoParams.duration否时长（秒）
videoParams.resolution否如 720p
videoParams.aspectRatio否如 16:9
videoParams.extraParamsJson否平台已支持的厂商扩展字段（JSON 字符串）

完整说明见 异步任务（图像/视频/文本）。
Seedance 2.0 多模态参考、ratio=adaptive 等见 Seedance 系列。

平台出参

提交响应：taskId、status: queued。

查单 GET /api/ai/tasks/{taskId}：

字段说明
statuspending / running / completed / failed / cancelled
progress执行进度 0–100
resultUrlPublic完成后的视频 URL（优先使用）
error / errorCode失败原因

Webhook 字段见 Webhook 回调。

厂商全量参数

Seedance 侧镜头、音频、多模态参考等完整字段以火山方舟官方文档为准；平台已支持的扩展键可通过 videoParams.extraParamsJson 传递：