Sora2 使用角色客串

OpenAPI Specification

接口：POST /v2/videos/generations（完整地址 https://api.allyang.cn/v2/videos/generations）

鉴权：请求头 Authorization: Bearer {{YOUR_API_KEY}}。

请求头

Content-Type：必填，固定 application/json。
Authorization：可选，string，默认 Bearer {{YOUR_API_KEY}}。

请求体参数（application/json）

prompt：必填，string，视频提示词；调用角色时需与提示词之间留空格，示例 @{角色1Username} 在一个舞台上和 @{角色2Username} 牵手跳舞。
model：必填，string，取值 sora-2、sora-2-pro（后者支持 hd、15s）。
images：可选，array，元素为 string，图片列表，支持 URL 与 base64。
aspect_ratio：可选，string，输出比例，取值 16:9（横屏）、9:16（竖屏）。
hd：可选，boolean，默认 false，是否生成高清；高清会导致生成速度更慢，且仅 sora-2-pro 支持。
duration：可选，string，视频时长，取值 10、15、25；其中 25s 仅 sora-2-pro 支持。
notify_hook：可选，string，原文未给出说明。
watermark：可选，boolean，原文未给出说明（示例值 false）。
private：可选，boolean，默认 false，是否隐藏视频；为 true 时视频不会发布，也无法进行 remix 二次编辑。
character_url：可选，string，创建角色所需的视频链接；视频中一定不能出现真人，否则会失败。
character_timestamps：可选，string，角色出现的秒数范围，格式 {start},{end}，且 end 与 start 的差值需在 1 至 3 秒之间。

原文档以 PS 注明：此处的「角色」指的是物品，不是人物。

响应

200：成功；原文未给出响应字段，待补。

使用提示：本平台 Base URL 为 https://api.allyang.cn，OpenAI 兼容接口路径以 /v1 开头；示例里的 {{YOUR_API_KEY}} 请替换为控制台创建的令牌。补充说明：角色客串可把生成或上传视频中的对象提取为角色，再作为「客串角色」放入新视频，角色可以是宠物、朋友，也可以是想象中的怪物、英雄等（甚至由日常物品衍生）。原文注明此处「角色」指物品，人物需走 face id 录入，暂不支持上传。