Popto 批量生成口播视频
为每条脚本、数字人和外观组合提交一个视频渲染任务，可独立设置字幕；音频试听不是必经步骤。
https://popto.cn/api/open/v1/toolbox/batch_render_avatar鉴权与请求头
在 API 密钥管理 ↗ 创建密钥，每次请求在 HTTP Header 中携带。
AuthorizationBearer <POPTO_API_KEY>必填Content-Typeapplication/json必填请求参数 Body · JSON
首次提交可省略或留空，自动创建工具箱项目；后续音频和视频提交复用同一 tool_id，项目须属于当前用户。
视频生成配置，至少一项。
查看数组元素字段 8
展开查看对象字段。
查看子字段 6
口播主题。
内容角度。
口播正文，使用时须为非空文本。
表达风格。
可选的文案来源 ID。
可选的文案版本。
口播正文，优先于 voiceover.draft；两者至少一个为非空文本。
数字人对象，可直接保留列表返回的完整对象。提交时至少包含 actor_id。
查看子字段 35
从数字人列表取得的真实角色 ID，不能为空。
数字人名称，建议保留以便项目展示。
角色记录 ID。
创建时间，Unix 秒。
更新时间，Unix 秒。
角色租用信息。
角色租用时间。
年龄分类。
性别。
适用场景。
姿势。
景别。
肤色。
配饰信息，JSON 值。
声音 ID；使用角色已配置的声音。
角色适用信息，JSON 值。
预览地址。
角色照片地址。
原始展示视频地址。
展示视频地址。
光照描述。
声音试听地址。
角色评分。
当前用户是否收藏。
角色状态；自建角色可能仍在生成中。
角色声音信息，JSON 值。
声音服务商。
声音账号标识。
族裔。
姿势标签。
景别标签。
行业标签。
地区。
职业标签。
可选外观；使用其中的 look_id，不要根据名称猜测 ID。
查看数组元素字段 10
外观 ID。
外观名称。
背景图地址。
服装图地址。
外观结果图地址。
外观描述。
外观状态码。
创建时间，Unix 秒。
外观预览图片或视频地址。
外观生成错误信息。
是否给成片叠加字幕，默认 false。
完整字幕样式对象，建议直接使用字幕预设列表的返回项；不能只传 ID。
查看子字段 13
字幕样式 ID。
样式名称。
字体名称，从字体列表选择。
可选字体文件 URL。
字体大小。
是否加粗。
是否斜体。
文字颜色。
背景颜色。
描边颜色。
描边宽度。
透明度。
字间距。
可选试听音频 URL，保存为任务元数据；当前视频合成仍按脚本和角色驱动，不承诺直接复用该音轨。
口播时长，整数秒。正值参与预扣费计算；省略或非正值时按正文约 5 字/秒向上取整估算。
每个非空 ID 生成一个视频；省略、空数组或仅含空白时使用默认外观。
返回值与结构
成功时 ret = 0，业务数据位于 data.ent。以下为 data.ent 中的字段。
工具箱项目 ID。
按输入配置及各外观顺序展开的任务 ID 数组；每条配置可能返回多个任务。
调用说明
- 每条 selected_render_avatars 按非空 selected_look_ids 逐个展开；未选择外观时只生成一个默认外观视频。批量权益按展开后的视频数量校验，超限返回 70010。
- 通过 task/batch_get 或 toolbox/get_info 查询 task_type=aiactor_perform_render_avatar；status=success 后读取 outputs.items[].output_video_url，可选字段包括 output_mime_type、workspace_id、workspace 与 analysis。
- 可以先生成音频，再携带同一 tool_id、audio_url 和向上取整的真实 duration 生成视频；audio_url 当前仅作元数据保存，duration 用于费用计算，不应据此承诺成片直接复用试听音轨。
- 按预估时长预扣视频积分，失败由原任务逻辑处理退款。循环提交中途失败可能已经创建部分任务，没有整批回滚保证；先核对已创建的任务。
- 接口使用 Bearer API Key 识别当前注册用户，生成服务身份由服务端加载，不需要也不能通过请求体覆盖 uid、owner 或 h_m。
- 提交接口没有幂等保证；网络超时、5xx 或不完整回执时可能已经创建任务。先用已保存的 tool_id、task_id 或项目中心核对，不要自动重放生成请求。