ModelSell Docs
VideosSeedance

查询 Seedance 2.0 / 2.5 视频任务

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

查询 Seedance 2.0 / 2.5 异步视频任务。网关已部署草稿模式支持,实际可用性取决于所选渠道、上游账号和模型。内置 Seedance 渠道的此原生查询入口统一返回方舟格式,成功为 succeeded,视频地址为 content.video_url,id 为 ModelSell 公共任务 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 使用原样片的 ModelSell 公共 ID。通用 GET /v1/videos/{task_id} 的对应字段位于 metadata.draft 和 metadata.draft_task_id。无需读取上游私有样片 ID。

Authorization

bearerAuth
AuthorizationBearer <token>

使用 Authorization Bearer API Key 进行鉴权。

In: header

Path Parameters

task_id*string

视频生成任务 ID。

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/api/v3/contents/generations/tasks/task_123456"

{
  "id": "task_UPUfjg0S3UXekH2OgTZBXyqgGhsxgkp6",
  "status": "running",
  "model": "doubao-seedance-2-0-260128"
}

{
  "error": {
    "code": "string",
    "message": "string",
    "request_id": "string"
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "request_id": "string"
  }
}

Video Generation

使用 Seedance 2.0 / 2.5 官方 `content[]` 格式创建异步视频生成任务。支持文生视频、图生视频、视频生视频、图像与音频组合、视频与音频组合,以及图像、视频、音频全模态引用。 **素材支持自动上传。** 在 `content[].image_url.url`、`content[].video_url.url` 或 `content[].audio_url.url` 中直接传入公网可访问的 `https://` 链接,系统会自动识别并上传素材,无需提前调用 `/api/assets/upload`。 若希望使用 ModelSell 的通用视频格式,也可以调用 `/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 样片。待样片成功后,第二步使用本用户的 ModelSell 公共任务 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。高级字段需所选渠道支持,通用格式不能假定透传全部原生字段。

Upload Asset

上传图片、视频或音频素材到当前用户素材库。素材上传接口同时支持国内版本和海外版本模型:国内版本模型不需要传入 `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>` 引用。