Skip to main content
POST
  • 只接收公网 URL,不支持本地文件上传,也不支持 data: 格式的 Base64 数据。
  • 异步接口:创建后立即返回素材 Id,素材可能仍在处理。请调用 查询素材处理状态 每 2 秒查询一次,直到 Status 为 Active。
  • 素材可用后,在 Seedance 视频生成 的 content 中把 URL 写成 asset://<Id> 即可引用,见 在视频生成中使用。

鉴权

string
必填
Bearer <API Key>。在 API 密钥 页面创建。

请求参数

string
必填
素材的公网直链,必须以 http:// 或 https:// 开头,建议使用 HTTPS。链接需要无需登录即可直接下载。
string
默认值:"Image"
素材类型:Image、Video 或 Audio,不区分大小写。
string
素材名称,不超过 64 个字符。不传时使用 URL 中的文件名。

支持格式与限制

响应

boolean
固定为 true。失败时返回 error 结构,见 错误响应。
string
素材 ID,通常以 asset- 开头。请保存该值,用于查询处理状态和在视频生成中引用。
string
初始处理状态,部分响应会返回。未返回时请直接调用查询接口获取状态。

查询素材处理状态

GET /v1/seedance/asset/{id} 创建接口返回后素材可能仍在处理。建议每 2 秒查询一次,直到 result.Status 为 Active。
cURL

路径参数

响应示例

200

响应字段

处理状态

在视频生成中使用

素材变为 Active 后,在 Seedance 视频生成请求的 content 中,把对应的 URL 写成 asset://<Id>:
视频和音频素材同理,分别写在 video_url.url 和 audio_url.url 中。
  • 素材 ID 只能在本平台的 Seedance 视频生成中使用。
  • result.URL 会过期,请保存 result.Id,不要保存 result.URL。

错误响应

错误使用 OpenAI 风格的错误体,格式见 错误码。创建和查询接口共用以下错误码: