不建议作为默认接入路径。 直接在视频生成请求中传入公共可访问的图片、视频或音频 URL 即可。平台会在需要时自动完成素材送审,并将请求按协议透传至上游,无需先调用素材库 API。
推荐:直接使用公网 URL
对绝大多数视频生成请求,素材库不是必经步骤。保持现有 URL 调用方式即可:
- 在视频生成请求中直接传入公共可访问的素材 URL。
- 平台自动处理该请求所需的素材送审。
- 请求按原协议透传,不需要提前创建素材组或取得素材 ID。
何时才需要素材库
仅在业务明确依赖素材 ID 时考虑使用,例如:
- 同一素材会被大量、长期复用,希望以稳定的素材 ID 引用。
- 现有系统已经接入火山 Assets API,希望尽量少改代码迁移。
- 需要通过 API 管理素材组以及素材的查询、更新和删除。
接口定义以火山官方文档为准
除鉴权方式和请求地址外,Action、版本、请求参数、响应字段及状态均与火山官方 Assets API 保持一致。本站仅提供兼容透传入口,不另行定义接口细节。
火山官方文档是接口字段与行为的唯一准则。官方新增或调整参数时,请直接按最新版文档调用。
本站鉴权方式
将火山官方请求地址替换为本站 /ark/ 入口,并使用本站 API Key 通过 Bearer Authentication 鉴权。
请求入口与鉴权
POST https://zerofa.ai/ark/?Action=<Action>&Version=2024-01-01
Authorization: Bearer sk-zerofa-xxx
Content-Type: application/json不要在本站请求中使用火山 AK/SK 签名;请求 Body 继续使用火山官方定义。
当前支持范围
当前兼容普通素材资产和私域真人人像素材库。真人认证及素材参数继续遵循火山官方定义。