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

查询 Seedance 2.0 / 2.5 视频任务

GET
/api/v3/contents/generations/tasks/{task_id}

查询 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。

Authorization

bearerAuth
headerAuthorizationBearer <API key>

使用 Authorization Bearer API Key 进行鉴权。

Path Parameters

task_id*string

视频生成任务 ID。

Response Body

Seedance 2.0 / 2.5 视频任务状态响应。

application/json
  1. response

方舟原生任务结果;字段随状态、模型和渠道变化。omni_reference_task_type 不是官网约定的返回字段。

id?string

goldflow.cc 公共任务 ID。

status?string

超过执行时限可为 expired;失败、取消和过期均应停止轮询。

Value in"queued""running""succeeded""failed""cancelled""expired"
model?string

实际使用的模型名称与版本。

created_at?integer

创建时间,Unix 秒级时间戳。

updated_at?integer

状态更新时间,Unix 秒级时间戳。

content?

成功后的输出内容;官方 URL 有效期 24 小时,2.5 视频 URL 最多下载 100 次。

duration?integer

实际时长约数,官方为实际总帧数除以 24 向下取整;不是请求的 -1。与 frames 二选一。

frames?integer

其他模型按帧数生成时的输出帧数,与 duration 二选一。

framespersecond?integer

输出帧率。

resolution?string

实际分辨率。

ratio?string

实际宽高比。

output_format?string

实际输出格式,2.5 字段。

Value in"mp4""mov"
generate_audio?boolean

实际是否含同步音频。

execution_expires_after?integer

从创建时间计算的任务时限,单位秒。

safety_identifier?string

请求设置且渠道支持时回传的终端用户标识。

tools?array<>

实际使用的工具;未使用时可省略。

usage?
error?|

任务失败信息;成功时可能为 null。

seed?integer

上游实际种子;不表示 2.5 支持请求 seed。

service_tier?string

实际服务等级;2.5 不支持 flex 请求。

draft?boolean

Seedance 2.5 是否样片;样片为 true,普通视频或正式片为 false,以上游实际返回为准。

draft_task_id?string

在包含样片功能的网关版本中,基于样片生成正式片时返回原样片的 goldflow.cc 公共任务 ID。

[key: string]?any
Example Request
curl -X GET 'https://goldflow.cc/api/v3/contents/generations/tasks/task_123456'
Example Response
{  "id": "task_UPUfjg0S3UXekH2OgTZBXyqgGhsxgkp6",  "status": "running",  "model": "doubao-seedance-2-0-260128"}

视频生成

使用 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`。完整约束与渠道差异见 [请求与返回参数](/docs/api-reference/seedance-2/parameters)。 网关已部署草稿模式支持,实际可用性取决于所选渠道、上游账号和模型。尚未完成真实付费样片及正式片生成验证。第一步传 `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](https://docs.volcengine.com/docs/ark/create-video-generation-task-api?lang=zh) 与 [Seedance 2.5 样片教程](https://docs.volcengine.com/docs/ark/seedance-2-5?lang=zh)。 官方字段已于 2026-09-07 核对 https://docs.volcengine.com/docs/82379/1520757 和 https://docs.volcengine.com/docs/82379/1521309。高级字段需所选渠道支持,通用格式不能假定透传全部原生字段。

上传素材

上传图片、视频或音频素材到当前用户素材库。素材上传接口同时支持国内版本和海外版本模型:国内版本模型不需要传入 `model` 查询参数;海外版本 `dreamina-seedance-2-0-fast-260128` 需要在请求地址添加 `?model=dreamina-seedance-2-0-fast-260128`,系统会选择对应的海外版本素材渠道。 该接口只接受公网 URL,不支持 Base64;上传成功后可在 Seedance 2.0 官方 `content[]` 格式或 `/v1/video/generations` 通用视频格式中使用 `asset://<asset_id>` 引用。