创建角色

以下内容来自 Apifox 快照，可能包含兼容层字段或旧示例；公开调用请以本页的协议说明和当前模型列表为准。

{
  "id": 495899725,
  "name": "创建角色",
  "type": "http",
  "serverId": "",
  "preProcessors": [],
  "postProcessors": [],
  "inheritPreProcessors": {},
  "inheritPostProcessors": {},
  "description": "",
  "operationId": "",
  "sourceUrl": "",
  "method": "post",
  "path": "/sora/v1/characters",
  "tags": [],
  "status": -2,
  "requestBody": {
    "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"
      ]
    },
    "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}"
      }
    ],
    "mediaType": "",
    "oasExtensions": "",
    "required": false,
    "additionalContentTypes": []
  },
  "parameters": {
    "path": [],
    "query": [],
    "cookie": [],
    "header": []
  },
  "commonParameters": {
    "query": [],
    "body": [],
    "cookie": [],
    "header": []
  },
  "auth": {},
  "responses": [
    {
      "id": 187261345,
      "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": []
    }
  ],
  "responseExamples": [
    {
      "name": "成功示例",
      "responseId": 187261345,
      "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}",
      "description": "",
      "oasKey": "",
      "oasExtensions": "",
      "id": "019fc09b-0b1f-742f-b946-24186f1eeacb"
    }
  ],
  "codeSamples": [],
  "projectId": 8662722,
  "moduleId": 8310462,
  "folderId": 92436132,
  "ordering": 30,
  "responsibleId": 0,
  "commonResponseStatus": {},
  "advancedSettings": {
    "disabledSystemHeaders": {}
  },
  "customApiFields": {},
  "oasExtensions": "",
  "mockScript": {},
  "createdAt": "2026-08-02T03:53:34.000Z",
  "updatedAt": "2026-08-06T12:15:55.000Z",
  "creatorId": 2863449,
  "editorId": 2863449,
  "creatorUserId": 2863449,
  "editorUserId": 2863449,
  "responseChildren": [],
  "visibility": "INHERITED",
  "securityScheme": {},
  "callbacks": ""
}