上传 Seedance 2.0 素材
上传图片、视频或音频素材到当前用户素材库。素材上传接口同时支持国内版本和海外版本模型：国内版本模型不需要传入 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 使用 Authorization Bearer API Key 进行鉴权。
In: header
Query Parameters
指定用于选择素材上传渠道的模型 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"
}
}{
"error": {
"code": "string",
"message": "string",
"request_id": "string"
}
}查询视频任务
查询 Seedance 2.0 / 2.5 异步视频任务。网关已部署草稿模式支持，实际可用性取决于所选渠道、上游账号和模型。内置 Seedance 渠道的此原生查询入口统一返回方舟格式，成功为 `succeeded`，视频地址为 `content.video_url`，`id` 为 cb4xw1qutzmfp5e2kuuibuxqln5t7ss9.agent-cname.modelsell.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` 使用原样片的 cb4xw1qutzmfp5e2kuuibuxqln5t7ss9.agent-cname.modelsell.cc 公共 ID。通用 `GET /v1/videos/{task_id}` 的对应字段位于 `metadata.draft` 和 `metadata.draft_task_id`。无需读取上游私有样片 ID。
查询素材详情
根据素材 ID 查询单个素材详情。素材状态为 `Active` 后，可在视频生成请求中使用 `asset://<asset_id>` 引用。