• 简体中文
  • 提交任务(豆包 / Seedance 格式)

    豆包视频模型(Seedance 系列,如 seedance-1-0-pro-250528、doubao-seedance-2-0-260128、doubao-seedance-2-0-mini-260615,以模型广场为准)复用通用任务格式的端点,无需单独对接(请求结构总览见创建视频生成任务)。本页说明豆包渠道的参数映射与渠道差异;查询与下载见查询与下载。

    端点

    创建与查询分别复用通用任务格式端点:POST /v1/video/generations、GET /v1/video/generations/{task_id}。

    请求体

    网关把请求转换为上游的 {model, content[], ...参数} 结构转发:prompt 转为上游 content 中的文本条目,image / images 转为图片条目;其余生成参数全部通过 metadata 按字段名合并进上游请求体(无法识别的 key 丢弃)。

    参数位置类型说明
    prompt顶层string必填,视频描述
    model顶层stringSeedance 模型名,网关按模型路由
    image / images顶层string / string[]图生视频首帧 / 参考图(URL 或 Base64),自动转为上游 content 图片条目
    seconds顶层string时长(秒)。⚠️ 豆包渠道读这个字段,顶层数字型 duration 不生效
    metadata.durationmetadatanumber时长(秒),与顶层 seconds 等价;同时传时 seconds 优先
    metadata.resolutionmetadatastring分辨率档位:480p / 720p / 1080p(按模型支持)。计费按此档位计算倍率
    metadata.ratiometadatastring画面比例:16:9 / 9:16 / 1:1 / 4:3 / 3:4(按模型支持)。⚠️ 顶层 size 不生效
    metadata.seedmetadatainteger随机种子
    metadata.generate_audiometadataboolean生成音频(Seedance 2.0 系支持),成功后产物带音轨
    metadata.watermarkmetadataboolean水印开关
    metadata.return_last_framemetadataboolean返回视频尾帧图,成功后在 data.data.content.last_frame_url
    metadata.camera_fixedmetadataboolean锁定机位:true 时无运镜(镜头固定),默认 false。实测 t2v 正常支持,true / false 运镜差异明显
    metadata.callback_urlmetadatastring上游状态回调地址(公网可达、可收 POST)。每个状态变化推送一次(queued / running / succeeded…),body 为上游任务对象 JSON,以 status 判断终态
    metadata.contentmetadataarray进阶:完整 content 条目数组,可含 video_url / audio_url 条目做视频参考 / 续写(其中 text 条目会被网关剔除,prompt 单独追加)
    metadata.frames / metadata.service_tiermetadata—❌ 上游对文生视频(t2v)不支持,传了返回 400(错误信息含上游 Request id);文生视频帧率固定 24fps,不可调。图生视频是否支持以上游文档为准
    WARNING

    顶层 duration、size、mode、width、height、fps、seed、n、response_format、user 在豆包渠道静默丢弃(不报错、不生效):时长用 seconds,画幅与分辨率用 metadata.ratio + metadata.resolution。实测对照:同一请求顶层 duration: 8 + seconds: "5",产出 5 秒;顶层 seed: 999 + metadata.seed: 42,回显 42。

    NOTE

    上游按「模型 × 模式」逐参数校验:不支持的组合在提交时直接返回 400(message 含模型名、模式与 Request id),按报错删掉对应参数重试即可。已实测(2026-09):

    • doubao-seedance-2-0-260128 t2v:resolution / ratio / seed / duration / generate_audio / return_last_frame / watermark / camera_fixed 均生效(1080p 产物与音轨实测;camera_fixed 为 2026-10 复测修正——t2v 传 200 正常建单,true / false 运镜差异明显);frames / service_tier 不支持
    • doubao-seedance-2-0-mini-260615 i2v:ratio / generate_audio 生效(720p 产物含音轨);resolution 不支持,不传时固定 720p
    • 文生视频帧率均为 24fps,不可调;其余「模型 × 模式」组合未实测,以上游报错为准
    WARNING

    图生视频(i2v)的 image / images 不接受真人照片:命中火山合规检测会直接返回 400 InputImageSensitiveContentDetected.PrivacyInformation(不建单、不计费)。首帧请改用插画 / 动漫 / 产品 / 风景类图片。

    请求示例

    cURL
    Python
    Node.js
    # 文生视频
    curl -X POST https://api-model.shuntianchuang.cn/v1/video/generations \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer sk-你的令牌" \
      -d '{
        "model": "doubao-seedance-2-0-260128",
        "prompt": "一只橘猫在草地上追蝴蝶,电影感镜头,缓慢推近",
        "seconds": "5",
        "metadata": {
          "resolution": "1080p",
          "ratio": "16:9",
          "seed": 42,
          "generate_audio": true,
          "return_last_frame": true
        }
      }'
    # 图生视频:image 传首帧图片 URL 或 Base64
    curl -X POST https://api-model.shuntianchuang.cn/v1/video/generations \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer sk-你的令牌" \
      -d '{
        "model": "doubao-seedance-2-0-260128",
        "prompt": "让画面中的猫跑起来,镜头缓慢推近",
        "image": "https://example.com/first-frame.jpg",
        "seconds": "5",
        "metadata": {
          "resolution": "1080p",
          "ratio": "16:9",
          "generate_audio": true
        }
      }'

    响应体

    提交成功返回任务对象,task_id 用于查询,status 起始为 queued。

    响应示例

    {
      "id": "task_xxxxxxxx",
      "object": "video",
      "task_id": "task_xxxxxxxx",
      "status": "queued",
      "progress": 0,
      "model": "doubao-seedance-2-0-260128",
      "created_at": 1769473000
    }

    查询状态与下载见查询与下载。