接入流程
- 调用
/v1/assets/upload 上传文件,获取素材 ID
- 视频生成请求中以
asset://{id} 形式引用素材
- 网关解析
asset:// 引用并替换为有效地址后转发上游,调用方无需处理地址有效期
1. 上传素材
以下示例中的密钥为当前登录凭证,可直接执行。
响应示例:
2. 查询素材列表
3. 视频生成引用
素材规格
| 类型 | 格式 | 大小 | 其他 |
| 图片 | jpg / png / webp / bmp / tiff / gif / heic | ≤30MB | 边长 300–6000px |
| 视频 | mp4 / mov | ≤200MB | 时长 2–30 秒 |
| 音频 | wav / mp3 | ≤15MB | — |
不符合规格的文件将被拒绝,响应体返回具体原因,例如「边长 100x100 超出要求 [300, 6000]px」。
火山兼容接口
已按火山方舟 universal OpenAPI 对接的系统,可通过兼容层接入,仅需变更 endpoint 与访问凭证,接口形态保持一致。
兼容层提供 10 个素材 Action,签名算法为火山 V4(HMAC-SHA256),详情参见完整接入指南。
错误码
| 状态码 | 含义 | 处理方式 |
| 401 | 密钥无效或已过期 | 更换有效密钥 |
| 403 | 公共库素材不允许删除 | 由平台管理员在服务端处理 |
| 413 | 存储配额不足 | 清理历史素材后重试 |
| 422 | 素材不符合规格 | 按响应提示调整后重新提交 |
注意事项
直链(/f/ 路径)为带签名的临时地址,有效期 12 小时。业务系统应持久化素材 ID,调用时使用 asset://{id},不应存储直链。
标记为「公共」的素材归属平台素材库,所有密钥均可引用,不可删除。
技术支持
反馈问题时请提供 HTTP 状态码与完整响应体,以便定位。