创建角色

POST https://az.gptplus5.com/sora/v1/characters

请求参数

Authorization

在 Header 添加参数Authorization，其值为在 Bearer 之后拼接 Token

示例：Authorization: Bearer ********************

Body 参数 (application/json)

参数名	类型	必需	说明
url	string	可选	视频中包含需要创建的角色 ,url 和from_task 二选一
timestamps	string	必需	单位秒，例如 ‘1,2’ 是指视频的1～2秒中出现的角色，注意范围差值最大 3 秒最小 1 秒
from_task	string	可选	可以根据已经生成的任务 id，来创建角色

请求示例

{
  // "url": "https://filesystem.site/cdn/20251030/javYrU4etHVFDqg8by7mViTWHlMOZy.mp4",
    "timestamps": "1,3",
    "from_task":"video_e50c76ca-21d4-40e9-8485-e4ead2d37133"
}

cURL 示例

curl --location --request POST 'https://az.gptplus5.com/sora/v1/characters' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  // "url": "https://filesystem.site/cdn/20251030/javYrU4etHVFDqg8by7mViTWHlMOZy.mp4",
    "timestamps": "1,3",
    "from_task":"video_e50c76ca-21d4-40e9-8485-e4ead2d37133"
}'

返回响应

🟢200成功

响应 Body

参数名	类型	必需	说明
id	string	必需
username	string	必需	角色名称，用于放在提示词中 @{username}
permalink	string	必需	角色主页，跳转到 openai 角色主页
profile_picture_url	string	必需

响应示例

{
    "id": "ch_6918d62178e48191a0b1ae49be428a13",
    "username": "hfspncadz.mooflapand",
    "permalink": "https://sora.chatgpt.com/profile/hfspncadz.mooflapand",
    "profile_picture_url": "https://videos.openai.com/az/files/00000000-b788-71f7-9de5-96555ff29024%2Fraw?se=2025-11-20T00%3A00%3A00Z&sp=r&sv=2024-08-04&sr=b&skoid=1af02b11-169c-463d-b441-d2ccfc9f02c8&sktid=a48cca56-e6da-484e-a814-9c849652bcb3&skt=2025-11-15T01%3A48%3A34Z&ske=2025-11-22T01%3A53%3A34Z&sks=b&skv=2024-08-04&sig=3/KGVtkEsZWBTmErhzUEU5pWrnL8JxRKH0wVCQvh6Fo%3D&ac=oaisdmntprsouthcentralus"
}