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 轮询或等待回调。
请求体参数
| 参数 | 类型 | 必填 | 说明 | 默认值/可选值 |
|---|---|---|---|---|
seed | integer | 否 | 随机种子,可复现结果(若上游支持) | — |
draft | boolean | 否 | 是否草稿模式(若上游支持) | — |
model | string | 否 | 公开模型名称。请从下方模型清单中选择一个名称;输入是否包含视频决定选择文生/图生或视频编辑名称,追求速度时选择 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 |
ratio | string | 否 | 画面宽高比。adaptive 表示由模型根据输入自动选择 | 默认:adaptive;16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / adaptive;示例:16:9 |
tools | array | 否 | 可选工具(仅文生视频支持 web_search 联网搜索) | 示例:[{"type":"web_search"}] |
frames | integer | 否 | 帧数相关参数(若上游支持) | — |
content | array | 否 | 多模态输入列表:支持 文本 + 图片 + 视频 + 音频 的任意组合。图片最多 9 张、视频最多 3 个、音频最多 3 段,且不可单独传音频。含 video_url 时按「含视频输入」档位计费。 | 示例:[{"text":"一只金毛犬在海边奔跑,夕阳西下","type":"text"}] |
duration | integer | 否 | 生成视频时长(秒)。取值 4~15,或 -1 由模型自动决定 | 默认:5;示例:5 |
watermark | boolean | 否 | 是否在视频右下角添加水印 | 默认:`` |
resolution | string | 否 | 输出分辨率 | 默认:720p;480p / 720p / 1080p;示例:720p |
callback_url | string | 否 | 异步任务完成/失败时的回调地址 | 示例:https://your-domain.com/webhook/seedance |
camera_fixed | boolean | 否 | 是否固定机位(若上游支持) | — |
service_tier | string | 否 | 服务档位(若上游支持) | — |
generate_audio | boolean | 否 | 是否生成与画面同步的音频 | 默认: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 元数据生成,可直接编辑。_