创建角色 Character

OpenAPI Specification

角色客串：基于已有视频或任务创建角色，完成后可在提示词中用 @ 调用，@ 与提示词之间需留空格。url 与 from_task 二选一必填。

请求方式：POST

接口地址

text

https://api.allyang.cn/sora/v1/characters

请求头

Content-Type（必填）：请求体类型，按本页标注填写。（示例：application/json）
Authorization（可选）：鉴权头，使用控制台创建的令牌，格式为 Bearer + 令牌。（示例：Bearer {{YOUR_API_KEY}}）

请求参数（application/json）

url（string，可选）：创建角色所需的视频，要求有声音且包含角色；url 与 from_task 二选一，必须设置其一。
timestamps（string，必填）：单位秒，例如 ‘1,2’ 表示视频第 1~2 秒出现的角色；范围差值最大 3 秒、最小 1 秒。
from_task（string，可选）：可依据已生成的任务 ID 创建角色；url 与 from_task 二选一，必须设置其一。

请求示例

json

{
  "url": "https://example.com/…",
  "timestamps": "1,3",
  "from_task": "video_637efe22-3b6a-47ad-ab02-ee01a686a0bd"
}

返回字段

id（string，必填）：角色 ID。
username（string，必填）：角色名称，可在提示词中以 @{username} 引用。
permalink（string，必填）：角色主页链接。
profile_picture_url（string，必填）：角色头像。

使用提示：该角色指可客串的“对象”（宠物、物品或想象角色），人物需走 face id 流程，暂不支持直接上传；提交后请用查询接口轮询结果；耗时、限流与计费数值以本平台实测与计费页为准（待补）。