Sora 创建角色

Sora 角色创建接口，用于创建可在后续视频任务中复用的 Character。

重要提示 (关于 New API / One API 兼容性)

New API / One API 平台目前不支持 /sora/v1/characters 接口。 由于中转分发平台不支持非标准的 OpenAI 路由，无法通过中转平台提交创建角色请求（会报错 404）。请绕过中转系统，直接向本站地址 https://api.gemai.cc 发起请求。

接口信息

项目	值
方法	POST
路径	/sora/v1/characters
完整地址	https://api.gemai.cc/sora/v1/characters
鉴权	Authorization: Bearer sk-你的令牌

请求体示例

{
  "name": "orange_cat",
  "description": "一只圆脸橘猫，绿色眼睛，戴红色围巾"
}

代码示例

cURL

curl --location 'https://api.gemai.cc/sora/v1/characters' \
  --header "Authorization: Bearer $GEMAI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "orange_cat",
    "description": "一只圆脸橘猫，绿色眼睛，戴红色围巾"
  }'

JavaScript

const response = await fetch('https://api.gemai.cc/sora/v1/characters', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.GEMAI_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    name: 'orange_cat',
    description: '一只圆脸橘猫，绿色眼睛，戴红色围巾',
  }),
})

console.log(await response.json())

Python

import os
import requests

response = requests.post(
    'https://api.gemai.cc/sora/v1/characters',
    headers={
        'Authorization': f"Bearer {os.environ['GEMAI_API_KEY']}",
        'Content-Type': 'application/json',
    },
    json={
        'name': 'orange_cat',
        'description': '一只圆脸橘猫，绿色眼睛，戴红色围巾',
    },
    timeout=120,
)

response.raise_for_status()
print(response.json())

返回示例

{
  "id": "character_xxx",
  "name": "orange_cat"
}

注意事项

• 创建后的角色 ID 可用于支持 Character 的 Sora 视频生成请求。
• 角色描述越明确，后续视频一致性越好。