Skip to main content
创建素材
提交公网 HTTPS 素材 URL,或直接以 multipart/form-data 上传本地文件。平台会将素材保存到平台存储并开始处理,返回平台素材 ID(asset_xxx)。
创建素材为异步接口,受理后返回 status=processing。需要轮询 GET /v1/assets/{id} 等待 status=active 后,才可在视频生成中使用该素材。 公开接口不需要传入 model 或模型 ID。素材上传会由平台内部按当前视频素材供应商配置完成路由。
视频生成请求中使用 uri 字段的值(即 asset://asset_xxx),不要使用 id 字段。传入时必须保留 asset:// 前缀。

请求参数

JSON URL 上传

文件上传

创建素材为异步接口,系统处理完成后素材状态变为 active。需轮询 GET /v1/assets/{id} 等待 status=active 后,才可在视频生成请求中使用。
视频生成时使用 uri 字段的值(即 asset://asset_xxx),不要使用 id 字段。传入时必须保留 asset:// 前缀。

素材格式要求


示例

JSON URL 上传

文件上传

响应(202 Accepted):

响应字段


素材状态


错误码

授权

Authorization
string
header
默认值:sk-your-api-key
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

asset_type
enum<string>
必填

素材类型。

可用选项:
image,
video,
audio
source_url
string
必填

公网可访问 HTTPS URL,平台会下载校验并保存。

name
string

素材名称。只能包含中文、字母、数字、下划线和短横线。

响应

素材已受理,正在处理中。

id
string

平台素材 ID,格式 asset_xxx

示例:

"asset_6f9a4c2b8d1e3a90"

uri
string

素材 URI,格式 asset://asset_xxx,视频生成请求中使用此值。

示例:

"asset://asset_6f9a4c2b8d1e3a90"

object
enum<string>
可用选项:
asset
asset_type
enum<string>
可用选项:
image,
video,
audio
name
string
status
enum<string>

素材状态:processing(处理中,不可用于生成)、active(可用)、 failed(处理失败)、disabled(已禁用)。

可用选项:
processing,
active,
failed,
disabled
resource_url
string<uri>

平台保存后的素材访问地址,通常为平台 CDN 地址;仅在列表接口传入 include_resource_url=1 且素材类型为图片或视频时返回。

created_at
integer
updated_at
integer