创建素材
视频生成
创建素材
提交公网 HTTPS 素材 URL,或直接以 multipart/form-data 上传本地文件。平台将素材保存到平台存储并开始处理,返回平台素材 ID(asset_xxx)。
公开素材上传接口不需要传入 model 或模型 ID,平台内部按当前视频素材供应商配置完成路由。
素材处理完成(status=active)后才可用于视频生成,传入格式为 asset://asset_xxx。
创建素材
提交公网 HTTPS 素材 URL,或直接以
创建素材为异步接口,受理后返回
响应(202 Accepted):
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 上传
文件上传
响应字段
素材状态
错误码
授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求体
响应
素材已受理,正在处理中。
平台素材 ID,格式 asset_xxx。
示例:
"asset_6f9a4c2b8d1e3a90"
素材 URI,格式 asset://asset_xxx,视频生成请求中使用此值。
示例:
"asset://asset_6f9a4c2b8d1e3a90"
可用选项:
asset 可用选项:
image, video, audio 素材状态:processing(处理中,不可用于生成)、active(可用)、
failed(处理失败)、disabled(已禁用)。
可用选项:
processing, active, failed, disabled 平台保存后的素材访问地址,通常为平台 CDN 地址;仅在列表接口传入 include_resource_url=1 且素材类型为图片或视频时返回。
.png?fit=max&auto=format&n=v_sJS-AFS6goKAv3&q=85&s=e03202fddb83c95be2a503ab9c79163a)