Skip to main content
基础 URL: 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 JavaScript

2. 从任务 ID 创建角色

如果您已经通过 Sora API 生成了视频,可以直接使用任务 ID 创建角色: curl Python

API 参考

端点

请求参数

timestamps 说明
  • 格式:"起始秒,结束秒",例如 "1,3" 表示视频的第 1 秒到第 3 秒
  • 时间范围差值:最小 1 秒,最大 3 秒
  • 确保指定的时间范围内角色清晰可见
urlfrom_task 二选一,不能同时提供或同时为空。

响应字段

响应示例

在视频中使用角色

创建角色后,您可以在视频生成的 prompt 中使用 @username 语法引用该角色。

使用示例

Python - 同步 API Python - 异步 API
提示词建议使用角色时,在 @username 后面描述角色的动作、场景和氛围,例如:
  • @username 在咖啡店里读书
  • @username 在海边散步,夕阳西下
  • @username 在办公室里工作,认真专注

完整工作流示例

以下是从视频生成到角色创建再到角色复用的完整流程:

常见问题

timestamps 时间范围有什么限制?
  • 最小范围:1 秒(如 "1,2"
  • 最大范围:3 秒(如 "1,4"
  • 确保在指定时间范围内角色清晰可见
  • 建议选择角色正面、光线良好的片段
可以创建哪些类型的角色? 支持从视频中提取各种角色:
  • 人物角色
  • 动物/宠物
  • 卡通形象
  • AI 生成的虚拟角色
  • 物品/道具
角色可以复用多少次? 创建的角色没有使用次数限制,可以在任意数量的视频生成中复用。 如何获得最佳角色提取效果? 建议:
  • 选择角色清晰可见的视频片段
  • 确保良好的光线条件
  • 选择角色正面或侧面清晰的画面
  • 避免角色被遮挡或模糊的片段

定价

角色创建按次计费,仅 $0.01/次。使用角色生成视频时,按正常视频生成价格计费。

相关链接

异步 API

推荐使用异步 API 生成视频

模型定价

查看完整的模型定价

代码示例

查看更多代码示例

常见问题

解决使用中的问题