创建一个来自上传视频的角色

POST

/v1/videos/characters

Sora2 专属 · 从上传视频创建可复用角色（POST /v1/videos/characters，multipart/form-data）。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数multipart/form-data

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/videos/characters' \
--header 'Authorization: Bearer <token>' \
--form 'name="可爱的小鱼"' \
--form 'video=@"C:\\Users\\Administrator\\Desktop\\下载.mp4"'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "id": "video_5c6a605a-30c0-4a6a-9dbd-d1d6cfdd9980",
    "object": "video",
    "model": "sora-2",
    "status": "queued",
    "progress": 0,
    "created_at": 1761622232,
    "seconds": "10",
    "size": "1280x720"
}

🟠400请求有误

🟠401没有权限

修改于 2026-10-24 18:33:19

openai 下载视频

openai 编辑视频