创建角色
POST /sora/v1/characters
概览
| Method | POST |
|---|---|
| Path | /sora/v1/characters |
| Type | http |
| Status | -2 |
| Module | 2102810 |
| Folder | 67877641 |
请求体
{ "type": "application/json", "parameters": [], "jsonSchema": { "type": "object", "properties": { "url": { "type": "string", "description": "视频中包含需要创建的角色 ,url 和from_task 二选一 \n" }, "timestamps": { "type": "string", "description": "单位秒,例如 ‘1,2’ 是指视频的1~2秒中出现的角色,注意范围差值最大 3 秒最小 1 秒\n" }, "from_task": { "type": "string", "description": "可以根据已经生成的任务 id,来创建角色\n" } }, "required": [ "timestamps" ], "x-apifox-orders": [ "url", "timestamps", "from_task" ] }, "mediaType": "", "examples": [ { "mediaType": "application/json", "value": "{\r\n // \"url\": \"https://filesystem.site/cdn/20251030/javYrU4etHVFDqg8by7mViTWHlMOZy.mp4\",\r\n \"timestamps\": \"1,3\",\r\n \"from_task\":\"video_e50c76ca-21d4-40e9-8485-e4ead2d37133\"\r\n}" } ], "oasExtensions": "" }
响应
[ { "id": 181200726, "name": "成功", "code": 200, "contentType": "json", "jsonSchema": { "type": "object", "properties": { "id": { "type": "string", "description": "角色id" }, "username": { "type": "string", "description": "角色名称,用于放在提示词中 @{username}" }, "permalink": { "type": "string", "description": "角色主页,跳转到 openai 角色主页" }, "profile_picture_url": { "type": "string", "description": "角色头像" } }, "required": [ "id", "username", "permalink", "profile_picture_url" ], "x-apifox-orders": [ "id", "username", "permalink", "profile_picture_url" ] }, "itemSchema": {}, "description": "", "mediaType": "", "headers": [] } ]
响应示例
[ { "name": "成功示例", "responseId": 181200726, "data": "{\r\n \"id\": \"ch_6918d62178e48191a0b1ae49be428a13\",\r\n \"username\": \"hfspncadz.mooflapand\",\r\n \"permalink\": \"https://sora.chatgpt.com/profile/hfspncadz.mooflapand\",\r\n \"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\"\r\n}", "id": "019a8909-24fb-77c8-9a01-7f4380ee5782" } ]