创建角色

POST /sora/v1/characters

MethodPOST
Path/sora/v1/characters
Typehttp
Status-2
Module2102810
Folder67877641

概览

MethodPOST
Path/sora/v1/characters
Typehttp
Status-2
Module2102810
Folder67877641

请求体

{
  "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"
  }
]