Seedance 2.0 · 创建任务

概述

提交 Seedance 2.0 视频生成任务。支持文生/图生/视频编辑/延长/多模态参考等场景。

鉴权

所有开放接口在请求头携带 API Key:

Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

请求

POST /api/v1/apps/seedance/create

本接口在平台侧为 异步 调用;提交后请根据返回的 task_id 轮询或等待回调。

请求体参数

参数类型必填说明默认值/可选值
seedinteger否随机种子,可复现结果(若上游支持)—
draftboolean否是否草稿模式(若上游支持)—
modelstring否公开模型名称。请从下方模型清单中选择一个名称;输入是否包含视频决定选择文生/图生或视频编辑名称,追求速度时选择 Fast 名称。seedance-2-text-2-video / seedance-2-video-2-video / seedance-2-fast-text-2-video / seedance-2-fast-video-2-video;示例:seedance-2-text-2-video
ratiostring否画面宽高比。adaptive 表示由模型根据输入自动选择默认:adaptive;16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / adaptive;示例:16:9
toolsarray否可选工具(仅文生视频支持 web_search 联网搜索)示例:[{"type":"web_search"}]
framesinteger否帧数相关参数(若上游支持)—
contentarray否多模态输入列表:支持 文本 + 图片 + 视频 + 音频 的任意组合。图片最多 9 张、视频最多 3 个、音频最多 3 段,且不可单独传音频。含 video_url 时按「含视频输入」档位计费。示例:[{"text":"一只金毛犬在海边奔跑,夕阳西下","type":"text"}]
durationinteger否生成视频时长(秒)。取值 4~15,或 -1 由模型自动决定默认:5;示例:5
watermarkboolean否是否在视频右下角添加水印默认:``
resolutionstring否输出分辨率默认:720p;480p / 720p / 1080p;示例:720p
callback_urlstring否异步任务完成/失败时的回调地址示例:https://your-domain.com/webhook/seedance
camera_fixedboolean否是否固定机位(若上游支持)—
service_tierstring否服务档位(若上游支持)—
generate_audioboolean否是否生成与画面同步的音频默认:1;示例:1

模型名称与使用场景

请求体中的 model 只能使用下表的公开模型名称。模型类型、名称和适用场景一一对应:

模型类型模型名称描述
Seedance 2.0 标准版seedance-2-text-2-video输入内容不包含视频,适合文生视频、图生视频、首尾帧生成
Seedance 2.0 标准版seedance-2-video-2-video输入内容包含视频,适合视频编辑、视频延长、视频参考
Seedance 2.0 快速版seedance-2-fast-text-2-video输入内容不包含视频,优先生成速度
Seedance 2.0 快速版seedance-2-fast-video-2-video输入内容包含视频,优先生成速度

除上述 4 个公开模型名称外,不需要填写其他模型名称。

请求示例

{
    "ratio": "adaptive",
    "duration": "5",
    "watermark": "",
    "resolution": "720p",
    "generate_audio": "1"
}

成功响应

{
  "code": 1,
  "msg": "success",
  "data": {
    "task_id": "task_xxxxxxxx"
  }
}

错误响应

{
  "code": 0,
  "msg": "错误说明",
  "data": null
}

_HTTP 4xx/5xx 时也可能以统一 JSON 返回,也可能携带 data.error 等;以实际接口行为为准。_


_本页由 php think ai_developer_doc:sync_from_source 根据应用 API 元数据生成,可直接编辑。_

同类文章