ModelSell Docs
VideosSeedance 2.0 / 2.5

查询 Seedance 2.0 / 2.5 视频任务

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

查询 Seedance 2.0 / 2.5 异步视频任务。方舟原生成功为 succeeded，读取 content.video_url；Service Inference / Max 为顶层 completed 和 outputs[0]，没有外层 task；部分渠道采用通用 video 响应。返回 id 均使用 ModelSell 公共任务 ID。

omni_reference_task_type 仅是请求字段，官网未承诺回传。duration 为实际时长约数，非请求的 -1。异步失败读取 error；方舟任务类型错误包括 InvalidParameter.TaskTypeConstraint 和 InvalidParameter.TaskTypeMismatch。方舟 URL 有效期 24 小时，2.5 视频最多下载 100 次；方舟只支持查询最近 7 天任务，其他渠道限制可能不同。

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)。 官方字段已于 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>` 引用。