ModelSell 文档
视频系列Seedance 2.0 / 2.5

上传 Seedance 2.0 素材

POST
/api/assets/upload

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

Authorization

bearerAuth
AuthorizationBearer <token>

使用 Authorization Bearer API Key 进行鉴权。

In: header

Query Parameters

model?string

指定用于选择素材上传渠道的模型 ID。上传 dreamina-seedance-2-0-fast-260128 海外版本素材时传入该参数。

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://example.com/api/assets/upload?model=dreamina-seedance-2-0-fast-260128" \  -H "Content-Type: application/json" \  -d '{    "url": "https://example.com/image.png",    "asset_type": "Image",    "name": "示例图片"  }'
{
  "code": 0,
  "message": "ok",
  "data": {
    "Id": "asset-20260325152211-vcchd"
  }
}
Empty
{
  "error": {
    "code": "string",
    "message": "string",
    "request_id": "string"
  }
}

查询视频任务

查询 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 天任务，其他渠道限制可能不同。

查询素材详情

根据素材 ID 查询单个素材详情。素材状态为 `Active` 后，可在视频生成请求中使用 `asset://<asset_id>` 引用。