Sora 视频生成与角色创建 API 文档

Base URL: https://bestapi.aqi.email
认证方式: Bearer Token

通用请求头:

一、创建视频（sora-2 / sora-2-pro）

接口地址:

用途: 创建视频任务，支持文生视频和图生视频。

1. 请求体参数

请求体示例:

{
  "images": [],
  "model": "sora-2",
  "orientation": "portrait",
  "prompt": "your prompt here",
  "size": "large",
  "duration": 10,
  "watermark": false,
  "private": true
}

参数说明:

images

类型: array[string]

是否必填: 是

说明:

图生视频: 传入图片 URL 数组

文生视频: 可传空数组 []

示例:

[]

["https://example.com/image1.png"]

model

类型: string

是否必填: 是

说明: 模型名称

sora-2: 标准版

sora-2-pro: 专业版

orientation

类型: string

是否必填: 是

说明: 视频方向

portrait: 竖屏

landscape: 横屏

prompt

类型: string

是否必填: 是

说明: 文本提示词，用于描述需要生成的视频内容

size

类型: string

是否必填: 是

说明: 视频质量

small: 一般为 720p

large: 高清 1080p

duration

类型: integer

是否必填: 是

说明: 视频时长（秒）

sora-2: 示例为 10 秒

sora-2-pro: 支持 15 秒、25 秒（以服务端实际支持为准）

watermark

类型: boolean

是否必填: 是

说明:

true: 优先无水印，如去水印失败则回退到有水印视频

false: 强制无水印，遇到去水印错误将持续自动重试

private

类型: boolean

是否必填: 是

说明:

true: 视频不会公开发布，且无法 remix（二次编辑）

false: 视频可公开和二次编辑

2. 模型差异

sora-2

适用: 标准质量、普通时长

分辨率: small(720p) / large(1080p)

时长: 示例为 10 秒

sora-2-pro

适用: 更高质量与更长时长场景

分辨率: large(1080p)

时长: 支持 15 秒、25 秒

3. 请求示例

sora-2 文生视频（无图片）

sora-2 图生视频（带图片）

sora-2-pro 高清长视频

4. 响应示例

任务型响应示例:

{
  "id": "sora-2:task_01k9008rhbefnt3rb1g9szxdwr",
  "status": "pending",
  "status_update_time": 1762010621323
}

字段说明:

类型: string

说明: 视频生成任务 ID

status

类型: string

说明: 任务状态

pending: 任务处理中

completed: 任务完成

failed: 任务失败

status_update_time

类型: integer

说明: 状态更新时间戳（毫秒）

部分实现可能返回更丰富结构（例如含 choices、usage 等），以实际返回为准。

二、创建角色

接口地址:

用途: 从指定视频中截取某一时间段的人物信息，创建可复用的角色。

1. 请求体参数

请求体示例:

{
  "url": "https://filesystem.site/cdn/20251030/javYrU4etHVFDqg8by7mViTWHlMOZy.mp4",
  "timestamps": "1,3"
}

参数说明:

url

类型: string

是否必填: 是

说明: 包含需要创建角色的源视频地址（可访问的 mp4 等视频链接）

timestamps

类型: string

是否必填: 是

说明:

时间范围，单位为秒

格式: "起始秒,结束秒"，例如:

"1,2" 表示 1～2 秒

"1,3" 表示 1～3 秒

范围差值最大 3 秒、最小 1 秒

2. 请求示例

3. 响应示例

{
  "id": "char_01k9abcd1234efgh5678",
  "username": "my_character",
  "permalink": "https://bestapi.aqi.email/sora/characters/my_character",
  "profile_picture_url": "https://bestapi.aqi.email/sora/characters/my_character/avatar.png"
}

字段说明:

类型: string

说明: 角色 ID

username

类型: string

说明: 角色名称/用户名

permalink

类型: string

说明: 角色永久链接

profile_picture_url

类型: string

说明: 角色头像图片地址

Sora 视频生成 API 文档

Sora 视频生成与角色创建 API 文档#

一、创建视频（sora-2 / sora-2-pro）#

1. 请求体参数#

2. 模型差异#

3. 请求示例#

4. 响应示例#

二、创建角色#

1. 请求体参数#

2. 请求示例#

3. 响应示例#

Sora 视频生成与角色创建 API 文档

一、创建视频（sora-2 / sora-2-pro）

1. 请求体参数

2. 模型差异

3. 请求示例

4. 响应示例

二、创建角色

1. 请求体参数

2. 请求示例

3. 响应示例