可复用参考

素材库

图片、视频和音频使用同一套素材接口。上传时自动识别类型;获得 asset_id 后,可在 images、videos、audios 或官方 content 中引用。切换同一团队有权限的分组时可继续传原 ID,平台按目标渠道自动准备素材并复用映射,无需手动重新上传;目标渠道仍须支持对应素材类型。

接口说明

通过公网 URL 创建素材

地址必须可由上游直接下载。首次上传按当前 API Key 的分组选择渠道,自动识别图片、视频或音频。跨分组复用依赖原 URL 仍可下载;短期签名 URL 建议改用文件上传。首次切换目标上游可能需要准备:收到 HTTP 409 / asset_preparing 时,等待 Retry-After 后重试原请求,不要重新上传。asset_upload_uncertain 表示上传结果待核对,请联系管理员,不要循环重试。

接口地址POST/v1/assets
Request body请求体参数
3 项
namestring选填

便于团队识别的素材名称,最长 128 个字符。

source_urlstring必填

公开可下载的图片、视频或音频地址。

asset_typeimage | video | audio选填

兼容参数,通常不需要填写。仅当远端地址没有可识别的 MIME 或扩展名时用于明确类型。

Response body响应体参数
6 项
asset_idstring选填

由接口按当前任务状态返回。

namestring选填

由接口按当前任务状态返回。

asset_typestring选填

由接口按当前任务状态返回。

statusstring选填

当前任务状态。

media_urlstring选填

由接口按当前任务状态返回。

image_urlstring选填

由接口按当前任务状态返回。