多参（Multi-Reference）角色视频生成 API 文档
概述
/v1/videos 接口直接传入角色参考图片和提示词，系统自动完成上传、创建角色、生成视频，一步到位。认证
Authorization: Bearer your-api-key可用模型
| 模型名称 | 方向 | 时长 | 额度消耗 |
|---|---|---|---|
sora2-landscape-reference-10s | 横屏 | 10秒 | 1 |
sora2-landscape-reference-15s | 横屏 | 15秒 | 2 |
sora2-portrait-reference-10s | 竖屏 | 10秒 | 1 |
sora2-portrait-reference-15s | 竖屏 | 15秒 | 2 |
POST /v1/videos
请求参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
prompt | string | 是 | - | 视频生成提示词 |
model | string | 是 | - | 模型名称（见上表） |
reference_images | array | 是 | - | 角色图片数组 |
async_mode | bool | 否 | true | 异步模式 |
reference_images 数组元素
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
name | string | 是 | 角色名称 |
description | string | 否 | 角色描述/性格 |
type | string | 否 | 类型，默认 character（可选值见下表） |
image | string | 是 | base64 字符串或图片 URL（http/https） |
type 可选值
| 值 | 说明 |
|---|---|
character | 角色（默认） |
setting | 场景/背景 |
style | 风格参考 |
other | 其他 |
请求示例
JSON 请求
响应（异步模式）
{
"id": "sora-2-abc123def456",
"object": "video",
"model": "sora2-landscape-reference-10s",
"status": "in_progress",
"progress": 0,
"created_at": 1702388400,
"seconds": "10",
"size": "1280x720"
}轮询视频状态
GET /v1/videos/{video_id}
{
"id": "sora-2-abc123def456",
"status": "in_progress",
"progress": 45
}{
"id": "sora-2-abc123def456",
"status": "completed",
"progress": 100,
"video_url": "https://...",
"generation_id": "gen_xxx"
}完整 Python 示例
修改于 2026-03-20 12:41:00