注册

Sora OpenAI 角色创建

POST https://api.quickrouter.ai/v1/videos/characters 在线调试 →
Authorization

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

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

请求参数

Header 参数
Content-Type string
必需
示例: application/json
Authorization string
必需
示例: Bearer $OPENAI_API_KEY
Body 参数 application/json
multipart/form-data
可选
name string
必需
定义角色名称。 最大长度80 最小长度1 示例: 可爱的小鱼
video file
必需
用于创建角色的视频文件。目前角色上传时,2 到 4 秒的短片段效果最佳 16:9 或 9:16,分辨率为 720p 到 1080p。角色源视频在匹配要求输出的画面比例时效果最佳。如果宽高比不同,角色可能会显得拉伸或变形。一个视频最多可包含两个角色。 示例: file://C:\Users\Administrator\Desktop\下载.mp4 请求
示例
{
    "id": "video_5c6a605a-30c0-4a6a-9dbd-d1d6cfdd9980",
    "object": "video",
    "model": "sora-2",
    "status": "queued",
    "progress": 0,
    "created_at": 1761622232,
    "seconds": "10",
    "size": "1280x720"
}

请求示例代码

curl --location --request POST 'https://api.quickrouter.ai/v1/videos/characters' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
  "id": "video_5c6a605a-30c0-4a6a-9dbd-d1d6cfdd9980",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1761622232,
  "seconds": "10",
  "size": "1280x720"
}'
var myHeaders = new Headers();
myHeaders.append("Accept", "application/json");
myHeaders.append("Authorization", "Bearer YOUR_API_KEY");
myHeaders.append("Content-Type", "application/json");

var raw = JSON.stringify({
  "id": "video_5c6a605a-30c0-4a6a-9dbd-d1d6cfdd9980",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1761622232,
  "seconds": "10",
  "size": "1280x720"
});

var requestOptions = {
   method: 'POST',
   headers: myHeaders,
   body: raw,
   redirect: 'follow'
};

fetch("https://api.quickrouter.ai/v1/videos/characters", requestOptions)
   .then(response => response.text())
   .then(result => console.log(result))
   .catch(error => console.log('error', error));
import http.client
import json

conn = http.client.HTTPSConnection("api.quickrouter.ai")
payload = json.dumps({
  "id": "video_5c6a605a-30c0-4a6a-9dbd-d1d6cfdd9980",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1761622232,
  "seconds": "10",
  "size": "1280x720"
})
headers = {
   'Accept': 'application/json',
   'Authorization': 'Bearer YOUR_API_KEY',
   'Content-Type': 'application/json'
}
conn.request("POST", "/v1/videos/characters", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

返回响应

响应参数 🟢 200 OK · application/json
object
可选
{ "id": "video_5c6a605a-30c0-4a6a-9dbd-d1d6cfdd9980", "object": "video", "model": "sora-2", "status": "queued", "progress": 0, "created_at": 1761622232, "seconds": "10", "size": "1280x720" }