Skip to Content
goldflow.cc 文档
视频系列Seedance

Seedance 2.0 / 2.5 视频生成

POST
/api/v3/contents/generations/tasks

使用 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。高级字段需所选渠道支持,通用格式不能假定透传全部原生字段。

Authorization

bearerAuth
headerAuthorizationBearer <API key>

使用 Authorization Bearer API Key 进行鉴权。

Request Body

application/json
  1. body

Seedance 2.0 / 2.5 原生请求。内置火山渠道和全部 Seedance 模板转发这些字段。通用接口的高级选项放在 metadata 下;功能和默认值由所选上游模型决定。

model*string

Seedance 模型 ID 或 goldflow.cc 实际可用别名;omni_reference_task_type 仅 2.5 支持。

content*array<>

Seedance 2.0 / 2.5 官方格式的内容数组。

Items1 <= items
omni_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 生成正式片时自动继承任务类型,不得填写本字段。 官方未列出该返回字段,不能依赖回传。

Default"auto"
Value in"auto""reference""edit""extend"
generate_audio?boolean

是否生成同步音频;生成音频为单声道。true 为普通请求默认值;引用 draft_task 生成正式片时自动继承,不得填写本字段。

Defaulttrue
resolution?string

普通 2.5 请求默认 720p,支持 480p/720p/1080p;2.0 标准版还支持 4k;2.0 fast/mini 仅支持 480p/720p。2.5 样片必须显式为 480p;引用 draft_task 的正式片默认且仅支持 1080p。

Default"720p"
Value in"480p""720p""1080p""4k"
ratio?string

2.5 编辑、延长、首帧及首尾帧任务必须使用 adaptive。

Default"adaptive"
Value in"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

是否添加水印;需所选渠道支持。

Defaultfalse
output_format?string

仅 2.5;mp4 为通用输出,mov 用于专业后期。原生顶层和通用 metadata.output_format 均转发;需上游模型支持。

Default"mp4"
Value in"mp4""mov"
return_last_frame?boolean

是否返回尾帧图像,需渠道支持。

Defaultfalse
callback_url?string

状态回调地址,官方通知体同查询响应;需渠道支持,回调 ID 不保证转换为 goldflow.cc ID。

Formaturi
execution_expires_after?integer

从 created_at 起计算的任务时限(秒),需渠道支持。

Range3600 <= value <= 259200
Default172800
priority?integer

同 Endpoint 内排队优先级,越大越优先;需渠道支持。

Range0 <= value <= 9
Default0
safety_identifier?string

稳定的终端用户标识,建议使用哈希;需渠道支持。

Lengthlength <= 64
tools?array<>

可选工具;需渠道支持,由模型决定是否实际使用。

seed?integer

随机种子;显式 0 保留,模型支持范围以上游为准。

Formatint64
Range-1 <= value <= 4294967295
camera_fixed?boolean

固定镜头选项,仅在所选上游模型支持时使用;false 也会转发。

draft?boolean

Seedance 2.5 样片模式。true 时 resolution 必须为 480p;引用 draft_task 生成正式片时省略或设为 false,resolution 默认且仅支持 1080p。正式片的 content 只含一个 draft_task,不得再传提示词、媒体、duration、ratio、seed、generate_audio、omni_reference_task_type。需部署包含该功能的网关版本,并由所选渠道支持。

Defaultfalse
service_tier?string

服务等级,例如 default、flex;Seedance 2.5 不支持 flex,其他能力取决于上游模型。

frames?integer

按帧数指定输出,仅在所选上游模型支持时使用;与 duration 二选一。

Response Body

创建任务响应。方舟最小返回只有 id;其他渠道可能返回状态等字段。id 为 goldflow.cc 公共任务 ID。

application/json
  1. response

方舟最小创建响应只有 id;其他渠道可能有额外字段。提交成功不表示生成成功。

id*string

goldflow.cc 公共任务 ID,后续查询使用此值。

[key: string]?any
curl -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"}'
Example Response
{  "id": "task_UPUfjg0S3UXekH2OgTZBXyqgGhsxgkp6"}