🧞‍♂️
Sora 2 角色接口：虚拟角色、物品出镜

用户4997

1月25日修改

🚀

核心要义：

首先 API 禁止放入人脸。那么，API 调用场景，在提示词里加入 @id  ：唯一性的Cameo 出镜秀ID或 角色Character ID 即可让这些角色出镜。​

这也是保持角色一致性的有效办法。

如果需要人脸？需要真人录制 Cameo。

角色 API 程序化创建

为什么需要角色？万物可成角色，真人出镜不行：

很重要的应用场景：

•
电商：把电商里的商品做成角色，他就可以通过角色保持一致性，比如 商品包装上的品牌和商品信息等文字，他可以固定成一个角色，之后在提示词里 at 角色 ID，即可植入该商品，而保障商品的角色一致性；​

•
动漫：虚拟人物都特别适合做成角色；​

……

角色 API 概述

API易 - 角色创建接口 https://api.apiyi.com/sora/v1/characters

•
【已上线】支持通过视频URL创建角色，方便用户管理和复用角色​

•
【已上线】支持异步任务视频 ID 创建角色​

•
传入的视频长度：不超过 15s ​
◦
timestamps：角色出现的时间范围 单位秒，例如 ‘5,8’ 是指视频的5～8秒中出现的角色，注意范围差值最大3秒最小1秒。​

•
价格：限免期 定价很低 $0.01​

•
成功率：一般，可能需要重试，如果带入真人/AI 生成的人脸，甚至身体出现，生成角色会失败。另外本身因为是 iOS 逆向的技术，技术上的不稳定也存在；​

请求体：

视频 URL 请求

视频的Url 需要公网可访问，注意 CDN 设置为全球，以防 OpenAI 服务器读不到​

代码块

{​
    "model": "sora-2-character",​
    "url": "https://mycdn-gg.oss-us-west-1.aliyuncs.com/sora/64ba6b88-8540-4b73-bf05-7bd2e96bebd1.mp4",  #视频 url 视频中包含需要创建的角色​
    "timestamps": "5,8"  #string 角色出现的时间范围 单位秒，例如 ‘5,8’ 是指视频的5～8秒中出现的角色，注意范围差值最大3秒最小1秒​
}​

50%

common.docs_name - LarkCCM_Docs_Menu_Image

50%

视频 ID 请求

 复用之前生成的视频ID，进行生成角色。 视频id是需要成功生成视频的 id，且在一天内才有效。​

代码块

curl https://api.apiyi.com/sora/v1/characters \​
  -H "Content-Type: application/json" \​
  -H "Authorization: Bearer sk-" \​
  -d '{​
    "model": "sora-2-character",​
    "from_task": "video_f751abfd-87a9-46e2-9236-1d94743c5e3e",​
    "timestamps": "5,8"​
  }'​

输出字段

•
id：角色 ID，唯一性​

•
username：用户名（唯一性)，可用于提示词里​

•
display_name：展示名称​

•
permalink：角色主页地址​

•
profile_picture_url：主页封面图片地址​