本页把 素材库 与 视频生成 两组接口串成一条完整链路,实现角色一致性视频生成。
本页聚焦代码链路。素材库逐接口说明见 素材库 API;真实人像的认证前置步骤见 真人认证接口;生成参数全集见 视频生成 API。

链路总览

1

创建素材组

Action=CreateAssetGroup(虚拟形象)或走真人认证获得素材组
2

注册素材

Action=CreateAsset,提交公网媒体 URL(图片 / 视频 / 音频,用 AssetType 指定,默认图片)
3

等待素材 Active

Action=GetAsset 每 3 秒轮询,直到 Status: "Active"
4

发起生成

POST /api/v3/contents/generations/tasks,image_url 填 asset://素材ID
5

轮询任务

每 15–30 秒查询,直到 succeeded
6

下载成片

从 content.video_url 下载(2 小时内有效,不带 Authorization 头)
提示词中用「图片1」「图片2」按 content 顺序指代素材,不要出现 asset- 开头的素材 ID 字面量。

鉴权方式

本页的素材管理 Action 支持两种认证方式:
  • API Key:Authorization: Bearer sk-...,下方完整示例默认使用这种方式。
  • 火山官方 AK/SK:使用 API Key 所绑定的 AK/SK,按火山官方 HMAC-SHA256 方式签名;请求根路径为 /,Service 为 ark,Region 推荐 cn-beijing。
已有火山客户端只需将 Endpoint 和 AK/SK 替换为 LoopRouter 配置,Action、Version、JSON 请求体和响应解析不变。下面示例使用火山官方 Go SDK 对素材注册请求签名:
AK/SK 仅替代素材管理与真人认证 Action 的 Bearer 认证。POST /api/v3/contents/generations/tasks 等视频生成接口仍使用 API Key;本地文件 multipart/form-data 上传也继续使用 API Key。

完整代码

多素材进阶用法

  • 一次请求最多引用 9 张参考图,asset://、公网 URL、Base64 可以混用;但真实人脸只能走 asset://(且需真人认证)。
  • 可再叠加 0–3 段参考视频 与 0–3 段参考音频(音频不能单独出现,须至少配一张图或一段视频);携带参考视频的请求自动享受视频输入计费折扣。
  • 同一角色建议同时引用「全身照 + 面部特写」两张素材,提示词写「图片1为角色全身,图片2为角色面部」。
  • 同一请求中的多个 asset:// 素材必须来自同一账号。

常见报错速查

相关页面

能力总览

模型规格与定价

视频生成 API

全部生成参数

素材库 API

素材管理接口