Seedance 2.0 / 2.5 视频生成
使用 Seedance 2.0 / 2.5 官方 content[] 格式创建异步视频生成任务。支持文生视频、图生视频、视频生视频、图像与音频组合、视频与音频组合,以及图像、视频、音频全模态引用。
素材支持自动上传。 在 content[].image_url.url、content[].video_url.url 或 content[].audio_url.url 中直接传入公网可访问的 https:// 链接,系统会自动识别并上传素材,无需提前调用 /api/assets/upload。
若希望使用 goldflow.cc 的通用视频格式,也可以调用 /v1/video/generations 或 /v1/videos,通过 prompt、image、images、metadata.video_url、metadata.audio_url 等字段提交。
需要通过素材 ID 复用图片、视频或音频时,也可以手动调用 /api/assets/upload 上传素材,素材状态为 Active 后可在 content[].*_url.url 中传入 asset://<asset_id>。
Seedance 2.5 新增 omni_reference_task_type,默认 auto,可选 reference、edit、extend。编辑要求 reference_video、ratio: adaptive 和 duration: -1;延长要求 reference_video 和 ratio: adaptive。完整约束与渠道差异见 请求与返回参数。
网关已部署草稿模式支持,实际可用性取决于所选渠道、上游账号和模型。尚未完成真实付费样片及正式片生成验证。第一步传 draft: true、resolution: 480p 创建 Seedance 2.5 样片。待样片成功后,第二步使用本用户的 goldflow.cc 公共任务 ID:content 只含一个 {"type":"draft_task","draft_task":{"id":"task_…"}},model 与样片一致,resolution 省略或为 1080p,draft 省略或为 false。网关自动转换上游引用 ID 并沿用原渠道账号;不要直接传 cgt-… 或 mvt-…。
正式片自动复用样片的提示词、参考媒体、duration、ratio、seed、generate_audio、omni_reference_task_type,禁止再次显式传入。可重新指定 return_last_frame、output_format、watermark、service_tier、execution_expires_after、priority、callback_url、safety_identifier;省略时使用模型默认值,2.5 不支持 service_tier: flex。样片 ID 从 created_at 起 7 天有效,需成功完成才能引用。两步独立计费,正式片的输入视频类别和时长沿用第一步,样片产物本身不计作输入视频。
样片字段依据 2026-10-09 核对的 官方创建 API 与 Seedance 2.5 样片教程。
官方字段已于 2026-09-07 核对 https://docs.volcengine.com/docs/82379/1520757 和 https://docs.volcengine.com/docs/82379/1521309。高级字段需所选渠道支持,通用格式不能假定透传全部原生字段。
bearerAuthAuthorizationBearer <API key>使用 Authorization Bearer API Key 进行鉴权。
application/json- body
Seedance 2.0 / 2.5 原生请求。内置火山渠道和全部 Seedance 模板转发这些字段。通用接口的高级选项放在 metadata 下;功能和默认值由所选上游模型决定。
model*stringSeedance 模型 ID 或 goldflow.cc 实际可用别名;omni_reference_task_type 仅 2.5 支持。
content*array<>Seedance 2.0 / 2.5 官方格式的内容数组。
1 <= itemsomni_reference_task_type?SeedanceOmniReferenceTaskType仅 Seedance 2.5 的全模态参考任务。auto 由模型判定;reference 生成新视频;edit 编辑原视频;extend 延长原视频。 edit 要求至少一个 reference_video(待编辑视频实际 4–30 秒)、ratio=adaptive、duration=-1;extend 要求 reference_video 和 ratio=adaptive。 reference 无额外任务类型限制,但仍受模型基本范围约束。显式值会提前校验;实际类型不一致仍可异步失败。 auto 是普通请求的默认值;引用 draft_task 生成正式片时自动继承任务类型,不得填写本字段。 官方未列出该返回字段,不能依赖回传。
"auto""auto""reference""edit""extend"generate_audio?boolean是否生成同步音频;生成音频为单声道。true 为普通请求默认值;引用 draft_task 生成正式片时自动继承,不得填写本字段。
trueresolution?string普通 2.5 请求默认 720p,支持 480p/720p/1080p;2.0 标准版还支持 4k;2.0 fast/mini 仅支持 480p/720p。2.5 样片必须显式为 480p;引用 draft_task 的正式片默认且仅支持 1080p。
"720p""480p""720p""1080p""4k"ratio?string2.5 编辑、延长、首帧及首尾帧任务必须使用 adaptive。
"adaptive""16:9""4:3""1:1""3:4""9:16""21:9""adaptive"duration?|2.5 默认 -1,支持 -1 或 4–30 秒;2.0 支持 -1 或 4–15 秒。-1 由模型选择;2.5 编辑必须为 -1。
watermark?boolean是否添加水印;需所选渠道支持。
falseoutput_format?string仅 2.5;mp4 为通用输出,mov 用于专业后期。原生顶层和通用 metadata.output_format 均转发;需上游模型支持。
"mp4""mp4""mov"return_last_frame?boolean是否返回尾帧图像,需渠道支持。
falsecallback_url?string状态回调地址,官方通知体同查询响应;需渠道支持,回调 ID 不保证转换为 goldflow.cc ID。
uriexecution_expires_after?integer从 created_at 起计算的任务时限(秒),需渠道支持。
3600 <= value <= 259200172800priority?integer同 Endpoint 内排队优先级,越大越优先;需渠道支持。
0 <= value <= 90safety_identifier?string稳定的终端用户标识,建议使用哈希;需渠道支持。
length <= 64tools?array<>可选工具;需渠道支持,由模型决定是否实际使用。
seed?integer随机种子;显式 0 保留,模型支持范围以上游为准。
int64-1 <= value <= 4294967295camera_fixed?boolean固定镜头选项,仅在所选上游模型支持时使用;false 也会转发。
draft?booleanSeedance 2.5 样片模式。true 时 resolution 必须为 480p;引用 draft_task 生成正式片时省略或设为 false,resolution 默认且仅支持 1080p。正式片的 content 只含一个 draft_task,不得再传提示词、媒体、duration、ratio、seed、generate_audio、omni_reference_task_type。需部署包含该功能的网关版本,并由所选渠道支持。
falseservice_tier?string服务等级,例如 default、flex;Seedance 2.5 不支持 flex,其他能力取决于上游模型。
frames?integer按帧数指定输出,仅在所选上游模型支持时使用;与 duration 二选一。
创建任务响应。方舟最小返回只有 id;其他渠道可能返回状态等字段。id 为 goldflow.cc 公共任务 ID。
application/json- response
方舟最小创建响应只有 id;其他渠道可能有额外字段。提交成功不表示生成成功。
id*stringgoldflow.cc 公共任务 ID,后续查询使用此值。
[key: string]?anycurl -X POST 'https://goldflow.cc/api/v3/contents/generations/tasks' \ -H 'Content-Type: application/json' \ -d '{ "model": "doubao-seedance-2-5-260628", "content": [ { "type": "text", "text": "一只橘猫在阳光下的花园里追逐蝴蝶,镜头平稳跟随。" } ], "draft": true, "resolution": "480p", "duration": 5, "ratio": "16:9"}'{ "id": "task_UPUfjg0S3UXekH2OgTZBXyqgGhsxgkp6"}Python Polling and Download
Previous Page
Video Task Status
查询 Seedance 2.0 / 2.5 异步视频任务。网关已部署草稿模式支持,实际可用性取决于所选渠道、上游账号和模型。内置 Seedance 渠道的此原生查询入口统一返回方舟格式,成功为 `succeeded`,视频地址为 `content.video_url`,`id` 为 goldflow.cc 公共任务 ID。Service Inference / Max 的 `completed`、`outputs[0]` 结构仅作为旧版网关或第三方直接接口参考,不能与新版网关的原生查询格式混用。尚未完成真实付费样片及正式片生成验证。 `omni_reference_task_type` 仅是请求字段,官网未承诺回传。`duration` 为实际时长约数,非请求的 -1。异步失败读取 error;方舟任务类型错误包括 `InvalidParameter.TaskTypeConstraint` 和 `InvalidParameter.TaskTypeMismatch`。方舟 URL 有效期 24 小时,2.5 视频最多下载 100 次;方舟只支持查询最近 7 天任务,其他渠道限制可能不同。 新版原生查询的样片成功结果含 `draft: true`,基于样片创建的正式片结果中 `draft_task_id` 使用原样片的 goldflow.cc 公共 ID。通用 `GET /v1/videos/{task_id}` 的对应字段位于 `metadata.draft` 和 `metadata.draft_task_id`。无需读取上游私有样片 ID。