https://api.yelinai.com/sora/v1/characters
价格: $0.01/次
模型: sora-2-character
功能介绍
Sora 2 Character 功能允许您从视频中提取角色(人物、宠物、物品等),创建可复用的角色身份。创建后,您可以在后续的视频生成中通过@username 语法引用该角色,保持角色的一致性外观和特征。
角色提取
从视频片段中提取角色形象可复用
创建一次,多次复用一致性
保持角色外观和特征一致低成本
仅 $0.01/次前置要求
1 获取 API Key 登录 YeLIn AI 控制台 获取 API 密钥 2 准备视频素材 准备包含要提取角色的视频,可以是:- 视频 URL(可公开访问)
- 已完成的 Sora 视频任务 ID
快速开始
1. 从视频 URL 创建角色
curl Python JavaScript2. 从任务 ID 创建角色
如果您已经通过 Sora API 生成了视频,可以直接使用任务 ID 创建角色: curl PythonAPI 参考
端点
请求参数
timestamps 说明
- 格式:
"起始秒,结束秒",例如"1,3"表示视频的第 1 秒到第 3 秒 - 时间范围差值:最小 1 秒,最大 3 秒
- 确保指定的时间范围内角色清晰可见
url 和 from_task 二选一,不能同时提供或同时为空。
响应字段
响应示例
在视频中使用角色
创建角色后,您可以在视频生成的 prompt 中使用@username 语法引用该角色。
使用示例
Python - 同步 API Python - 异步 API@username 后面描述角色的动作、场景和氛围,例如:
@username 在咖啡店里读书@username 在海边散步,夕阳西下@username 在办公室里工作,认真专注
完整工作流示例
以下是从视频生成到角色创建再到角色复用的完整流程:常见问题
timestamps 时间范围有什么限制?- 最小范围:1 秒(如
"1,2") - 最大范围:3 秒(如
"1,4") - 确保在指定时间范围内角色清晰可见
- 建议选择角色正面、光线良好的片段
- 人物角色
- 动物/宠物
- 卡通形象
- AI 生成的虚拟角色
- 物品/道具
- 选择角色清晰可见的视频片段
- 确保良好的光线条件
- 选择角色正面或侧面清晰的画面
- 避免角色被遮挡或模糊的片段
定价
角色创建按次计费,仅 $0.01/次。使用角色生成视频时,按正常视频生成价格计费。