Sora2 API - 完整接口文档 - Sora2 API

企业级视频与图片生成API服务 | OpenAI标准格式

📚 目录

🎯 API端点总览

核心端点

端点	方法	说明	版本
`/v1/chat/completions`	POST	统一生成端点（OpenAI标准格式）	v1.0+
`/v1/videos`	POST	创建视频/角色任务（异步）	v1.0+
`/v1/videos/{video_id}`	GET	查询视频状态或角色信息	v1.0+
`/v1/videos/{video_id}/remix`	POST	Remix视频	v1.0+
`/v1/videos/{video_id}/content`	GET	获取视频内容	v1.0+
`/v1/images/generations`	POST	生成图片（OpenAI标准）	v1.2+
`/v1/images/edits`	POST	编辑图片（OpenAI标准）	v1.2+
`/v1/models`	GET	列出可用模型	v1.0+

内容格式支持

✅ application/json - JSON格式请求

✅ multipart/form-data - 表单数据格式（支持文件上传）

⚡ 高级功能

🎨 1. 视频风格控制（Style ID）

使用预设风格快速生成特定风格的视频，无需复杂的提示词描述。

支持的预设风格

风格ID	中文名	效果描述	适用场景
`festive`	节日风格	欢庆、热闹的氛围，色彩鲜艳	节日庆典、派对场景
`retro`	复古风格	怀旧、老式电影感，颗粒质感	回忆录、复古主题
`news`	新闻风格	正式、专业的新闻播报效果	新闻报道、正式场合
`selfie`	自拍风格	第一人称视角、亲密感强	个人Vlog、自拍视频
`handheld`	手持风格	手持摄影、纪实感、轻微抖动	纪录片、街拍
`anime`	动漫风格	日式动画风格、二次元效果	动画片、卡通内容

使用示例

{
  "model": "sora-2-landscape-15s",
  "prompt": "城市街道上的夜景，霓虹灯闪烁",
  "style_id": "retro"
}

🎭 2. 角色功能（Character）

上传视频创建角色，在后续生成中重复使用该角色，保持人物一致性。

专用模型：sora-2-characters

sora-2-characters 是专门用于角色创建和管理的模型，提供以下核心能力：

📹 角色提取 - 从视频中智能识别和提取角色特征

👤 角色管理 - 自动生成唯一的角色标识符（@username）

🔄 角色复用 - 在不同场景中保持角色一致性

⚡ 快速创建 - 无需额外参数，自动处理角色信息

功能模式

模式	模型选择	说明	使用场景
角色创建	`sora-2-characters`	上传视频，不提供prompt	仅提取角色信息
角色生成	任意视频模型	上传视频+提供prompt	创建角色并立即生成视频
角色复用	任意视频模型	在prompt中使用`@username`	使用已创建的角色

工作流程

完整示例

sora-2-characters 模型特点

特性	说明
输入要求	必须提供视频文件
输出内容	角色信息（username、display_name）
处理时间	通常 1-2 分钟
最佳实践	视频长度 3-10 秒，清晰展示角色正面

🎬 3. 分镜模式（Storyboard）

使用特定格式在单个视频中创建多个连贯的镜头，每个镜头指定时长。

格式规范

[时长s]镜头描述 [时长s]镜头描述 [时长s]镜头描述

要求

总时长必须等于视频总长度

支持换行分隔

每个镜头独立描述

示例

{
  "model": "sora-2-landscape-15s",
  "prompt": "[5.0s]开场：城市全景，镜头缓慢上升 [4.0s]转场：街道人群，人来人往 [6.0s]特写：主角微笑，阳光洒在脸上"
}

多行格式

{
  "model": "sora-2-landscape-15s",
  "prompt": "[5.0s]猫咪从飞机上跳伞，降落伞打开\n[5.0s]猫咪平稳降落在草地上\n[5.0s]猫咪在田野中快乐奔跑"
}

🔄 4. Remix 功能

基于已生成的视频继续创作，修改场景、风格或添加新元素。

支持的Remix ID格式

完整链接: https://sora.chatgpt.com/p/s_68e3a06dcd888191b150971da152c1f5
短ID格式: s_68e3a06dcd888191b150971da152c1f5

三种使用方式

方式一：在prompt中包含Remix ID

{
  "model": "sora-2-landscape-15s",
  "prompt": "https://sora.chatgpt.com/p/s_abc123... 改成水墨画风格"
}

方式二：使用remix_target_id参数

{
  "model": "sora-2-landscape-15s",
  "prompt": "改成水墨画风格，添加中国风音乐",
  "remix_target_id": "s_68e3a06dcd888191b150971da152c1f5"
}

方式三：使用专用Remix端点

📐 5. 智能方向检测

系统自动识别并设置视频方向，无需手动指定参数。

检测优先级（从高到低）

模型名称中的方向 - sora-2-landscape 或 sora-2-portrait

提示词关键词 - 横屏 或 竖屏

orientation参数 - 显式指定

模型默认方向 - 使用模型默认设置

示例

{
  "model": "sora-2",
  "prompt": "竖屏，一个女孩在跳舞"
}

系统自动识别竖屏关键词并设置为竖屏模式（9:16）。

🖼️ 6. 智能文件识别（input_reference）

使用单一参数同时支持图片和视频输入，系统自动识别文件类型。

自动检测规则

检测为视频的条件	检测为图片的条件
URL包含 `.mp4`, `.mov`, `.avi`, `.webm`, `.mkv`	其他所有情况（默认）
Data URI以 `data:video` 开头	-
MIME类型为 `video/*`	-

使用示例

📝 完整参数说明

必需参数

`model`

指定使用的生成模型。

视频模型

模型名称	时长	分辨率	说明
`sora-2`	15秒	1920×1080	通用横屏模型
`sora-2-15s`	15秒	1920×1080	15秒横屏
`sora-2-landscape`	15秒	1920×1080	横屏（16:9）
`sora-2-landscape-15s`	15秒	1920×1080	15秒横屏
`sora-2-portrait`	15秒	1080×1920	竖屏（9:16）
`sora-2-portrait-15s`	15秒	1080×1920	15秒竖屏
`sora-2-characters`	不生成视频	-	专用角色创建模型

图片模型

模型名称	分辨率	说明
`sora-image`	360×360	正方形图片
`sora-image-landscape`	540×360	横版图片
`sora-image-portrait`	360×540	竖版图片

示例

{
  "model": "sora-2-landscape-15s"
}

`prompt`

生成内容的文本描述或提示词。

特殊语法支持

语法	说明	示例
`横屏`/`竖屏`	自动设置视频方向	`"竖屏，一个女孩跳舞"`
`[时长s]描述`	分镜模式	`"[5.0s]开场 [10.0s]结尾"`
`@username`	引用角色	`"@john_doe 在跑步"`
Remix ID	视频Remix	`"s_abc123... 改成夜晚"`

示例

{
  "prompt": "一只可爱的橘猫在阳光下的草地上追逐蝴蝶，画面温馨自然"
}

可选参数

`style_id`

设置视频的视觉风格。

预设值: festive, retro, news, selfie, handheld, anime

示例

{
  "model": "sora-2-landscape-15s",
  "prompt": "街道夜景，霓虹灯闪烁",
  "style_id": "retro"
}

`orientation`

显式指定视频方向。

可选值: landscape（横屏）, portrait（竖屏）

注意: 如果模型名称已包含方向，此参数将被忽略。

示例

{
  "model": "sora-2",
  "prompt": "一个人在奔跑",
  "orientation": "portrait"
}

`image`

图片输入，用于图生视频功能。

支持格式

HTTP/HTTPS URL

{
  "image": "https://example.com/image.jpg"
}

Base64 编码（带或不带 data URI 前缀）

{
  "image": "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
}

或

{
  "image": "/9j/4AAQSkZJRg..."
}

文件上传（仅 multipart/form-data）

`video`

视频输入，用于角色创建功能。

支持格式: 同 image 参数（URL、Base64、文件上传）

功能说明

仅video，无prompt: 创建角色，返回角色信息

video + prompt: 创建角色并生成视频

示例

{
  "model": "sora-2",
  "prompt": "这个角色在跳舞",
  "video": "https://example.com/character.mp4"
}

`input_reference`

通用输入参考，自动识别为图片或视频。

自动检测逻辑

包含视频扩展名或 data:video → 视频

其他情况 → 图片

注意: 如果已提供 image 或 video，此参数将被忽略。

示例

`remix_target_id`

Remix目标视频的ID。

支持格式

完整分享链接

{
  "remix_target_id": "https://sora.chatgpt.com/p/s_68e3a06dcd888191b150971da152c1f5"
}

短ID格式

{
  "remix_target_id": "s_68e3a06dcd888191b150971da152c1f5"
}

注意: 也可以直接在 prompt 中包含Remix ID，系统会自动提取。

`size`

视频尺寸规格（主要用于兼容性）。

注意: 实际尺寸由 model 和 orientation 决定。

示例

{
  "size": "1280x720"
}

🔄 API端点详解

POST /v1/chat/completions

OpenAI标准格式的统一生成端点，支持图片和视频生成。

请求头

请求体

{
  "model": "sora-2-landscape-15s",
  "messages": [
    {
      "role": "user",
      "content": "一只猫在草地上玩耍"
    }
  ],
  "stream": true
}

支持的content格式

纯文本（文生图/文生视频）

{
  "content": "一只可爱的小猫"
}

多模态数组 - image_url 方式（图生视频）

{
  "content": [
    {
      "type": "text",
      "text": "让这只猫跳舞"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "data:image/jpeg;base64,..."
      }
    }
  ]
}

多模态数组 - text URL 方式（图生视频/角色创建）

支持通过 text 类型直接传入图片或视频的 URL，系统会自动识别：

{
  "content": [
    {
      "type": "text",
      "text": "让这只猫跳舞"
    },
    {
      "type": "text",
      "text": "https://example.com/image.jpg"
    }
  ]
}

或者传入视频 URL 创建角色：

{
  "content": [
    {
      "type": "text",
      "text": "https://example.com/character.mp4"
    },
    {
      "type": "text",
      "text": "这个角色在海边奔跑"
    }
  ]
}

包含视频 - video_url 方式（角色创建）

{
  "content": [
    {
      "type": "video_url",
      "video_url": {
        "url": "data:video/mp4;base64,..."
      }
    },
    {
      "type": "text",
      "text": "这个角色在跳舞"
    }
  ]
}

URL 传入方式对比

方式	格式	适用场景	示例
`image_url`	标准对象格式	图片引用	`{"type": "image_url", "image_url": {"url": "..."}}`
`video_url`	标准对象格式	视频引用	`{"type": "video_url", "video_url": {"url": "..."}}`
`text` URL	简化文本格式	图片或视频 URL	`{"type": "text", "text": "https://..."}`

注意: 使用 text 类型传入 URL 时，系统会自动根据 URL 特征（扩展名、协议等）识别为图片或视频。

响应格式

流式响应（stream=true）

data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","created":1702345678,"model":"sora-2","choices":[{"index":0,"delta":{"role":"assistant","content":"```html\n<video src='https://cdn.example.com/video.mp4' controls></video>\n```"},"finish_reason":"STOP"}],"usage":{"prompt_tokens":0,"completion_tokens":1,"total_tokens":1}}

data: [DONE]

非流式响应（stream=false）

{
  "id": "video_a1b2c3d4e5f6g7h8",
  "object": "video",
  "created_at": 1702345678,
  "status": "completed",
  "model": "sora-2-landscape-15s",
  "url": "https://cdn.example.com/video.mp4"
}

POST /v1/videos

创建视频生成任务（异步），支持JSON和multipart/form-data格式。

请求头

请求体（JSON格式）

{
  "model": "sora-2-landscape-15s",
  "prompt": "一只可爱的橘猫在阳光下的草地上追逐蝴蝶",
  "style_id": "retro",
  "orientation": "landscape"
}

请求体（Form格式）

响应格式

任务创建（queued）

{
  "id": "video_a1b2c3d4e5f6g7h8",
  "object": "video",
  "created_at": 1702345678,
  "status": "queued",
  "model": "sora-2-landscape-15s",
  "prompt": "一只可爱的橘猫在阳光下的草地上追逐蝴蝶",
  "progress": 0,
  "seconds": "15",
  "size": "1920x1080"
}

处理中（in_progress）

{
  "id": "video_a1b2c3d4e5f6g7h8",
  "object": "video",
  "status": "in_progress",
  "progress": 65,
  "seconds": "15",
  "size": "1920x1080"
}

完成（completed）

{
  "id": "video_a1b2c3d4e5f6g7h8",
  "object": "video",
  "status": "completed",
  "progress": 100,
  "video_url": "https://cdn.example.com/video.mp4",
  "share_id": "s_abc123def456789",
  "completed_at": 1702345888
}

角色创建响应

{
  "id": "char_abc123",
  "object": "character",
  "status": "completed",
  "username": "john_doe123",
  "display_name": "John Doe",
  "message": "角色创建成功，角色名@john_doe123"
}

GET /v1/videos/{video_id}

查询视频任务状态或角色创建信息。

功能说明

视频任务：查询视频生成的状态和进度

角色创建：查询角色创建状态，获取完整的角色信息（username、display_name）

请求示例

响应格式

视频任务响应: 同 POST /v1/videos

角色创建响应（当查询角色任务时）

{
  "id": "char_abc123",
  "object": "character",
  "status": "completed",
  "username": "john_doe123",
  "display_name": "John Doe",
  "message": "角色创建成功，角色名@john_doe123"
}

状态说明

状态	说明	progress
`queued`	排队中	0
`in_progress`	处理中	1-99
`completed`	已完成	100
`failed`	失败	0

POST /v1/videos/{video_id}/remix

基于现有视频创建Remix任务。

请求体

{
  "prompt": "改成夜晚场景，添加星空背景"
}

请求示例

响应格式: 返回新的视频任务，格式同 POST /v1/videos

GET /v1/videos/{video_id}/content

获取视频内容，支持直接访问或状态查询。

查询参数

参数	类型	说明	默认值
`variant`	string	内容类型	`video`

variant可选值

video - 视频文件（支持）

thumbnail - 缩略图（暂未实现）

spritesheet - 精灵图（暂未实现）

请求示例

响应

状态	HTTP码	说明
已完成	302	重定向到视频URL
处理中	202	返回状态JSON
失败	410	返回错误JSON

POST /v1/images/generations

生成图片（OpenAI标准格式）。

请求体

{
  "model": "sora-image",
  "prompt": "一只可爱的小猫",
  "size": "360x360",
  "response_format": "url",
  "n": 1
}

参数说明

参数	类型	必需	说明
`model`	string	可选	图片模型（默认根据size选择）
`prompt`	string	必需	提示词
`size`	string	可选	图片尺寸，默认`360x360`
`response_format`	string	可选	`url`或`b64_json`，默认`url`
`n`	integer	可选	生成数量，默认1

支持的size

360x360 → sora-image

540x360 → sora-image-landscape

360x540 → sora-image-portrait

响应格式

URL格式（response_format="url"）

{
  "created": 1702345678,
  "data": [
    {
      "url": "https://cdn.example.com/image.jpg"
    }
  ]
}

Base64格式（response_format="b64_json"）

{
  "created": 1702345678,
  "data": [
    {
      "b64_json": "/9j/4AAQSkZJRgABAQEA..."
    }
  ]
}

POST /v1/images/edits

编辑图片（OpenAI标准格式）。

请求头

请求体（JSON格式）

{
  "image": "https://example.com/image.jpg",
  "prompt": "将这张图片变成油画风格",
  "model": "sora-image",
  "size": "360x360",
  "response_format": "url"
}

请求体（Form格式）

响应格式: 同 POST /v1/images/generations

GET /v1/models

列出所有可用的模型。

请求示例

响应格式

{
  "object": "list",
  "data": [
    {
      "id": "sora-2-landscape-15s",
      "object": "model",
      "owned_by": "sora2api",
      "description": "Video generation - landscape"
    },
    {
      "id": "sora-image",
      "object": "model",
      "owned_by": "sora2api",
      "description": "Image generation - 360x360"
    }
  ]
}

💡 使用示例

示例 1: 文生视频（基础）

示例 2: 图生视频（使用URL）

示例 3: 使用风格参数生成视频

示例 4: 图生视频（表单上传）

示例 5: 上传文件（自动识别）

示例 6: 视频 Remix

示例 7: 仅创建角色（不生成视频）

上传视频提取角色信息，返回角色名称用于后续生成。

响应示例

{
  "id": "char_abc123",
  "object": "character",
  "status": "completed",
  "username": "john_doe123",
  "display_name": "John Doe",
  "message": "角色创建成功，角色名@john_doe123"
}

示例 8: 仅创建角色（专用模型）

使用专用的 sora-2-characters 模型创建角色，获得更快更准确的角色识别。

响应示例

{
  "id": "char_abc123",
  "object": "character",
  "status": "completed",
  "username": "john_doe123",
  "display_name": "John Doe",
  "message": "角色创建成功，角色名@john_doe123"
}

📌 重要提示：使用 /v1/videos 异步创建角色后，返回的响应仅包含基本信息（id、status 等）。要获取完整的角色信息（username、display_name），需要使用 GET /v1/videos/{char_id} 查询获取。

后续使用该角色

示例 9: 角色创建并生成视频

上传视频创建角色，同时使用该角色生成新视频。

示例 10: 分镜模式生成

使用分镜格式创建多镜头连贯视频。

示例 11: OpenAI 通用格式

11.1 文生视频

11.2 图生视频（多模态）

11.3 传入 URL（简化方式）

通过 text 类型直接传入图片或视频 URL，系统自动识别媒体类型。

图生视频示例

角色创建示例（使用视频 URL）

角色创建并生成视频

11.4 仅创建角色

流式响应示例

data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","created":1702345678,"model":"sora-2-characters","choices":[{"index":0,"delta":{"role":"assistant","content":null,"reasoning_content":"✨ 角色创建成功\n角色名: @sarah_chen456\n显示名: Sarah Chen\n提示: 在后续生成中使用 @sarah_chen456 来引用此角色","tool_calls":null},"finish_reason":"STOP"}],"usage":{"prompt_tokens":0}}

data: [DONE]

11.5 视频分镜

11.6 创建角色并生成视频

上传视频创建角色，同时使用该角色生成新视频。

流式响应示例

data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","created":1702345678,"model":"sora-2","choices":[{"index":0,"delta":{"role":"assistant","content":null,"reasoning_content":"✨ 角色已识别: John Doe (@john_doe123)\n","tool_calls":null},"finish_reason":null}],"usage":{"prompt_tokens":0}}

data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","created":1702345678,"model":"sora-2","choices":[{"index":0,"delta":{"content":"```html\n<video src='https://cdn.example.com/video.mp4' controls></video>\n```","reasoning_content":null,"tool_calls":null},"finish_reason":"STOP"}],"usage":{"prompt_tokens":0,"completion_tokens":1,"total_tokens":1}}

data: [DONE]

📊 错误处理

常见错误码

HTTP状态码	错误类型	说明	解决方案
`400`	`invalid_request_error`	参数验证失败	检查必需参数是否完整
`400`	`parameter_missing`	缺少必需参数	添加缺失的参数
`400`	`invalid_model`	模型名称无效	使用支持的模型名称
`403`	`authentication_error`	API密钥无效	检查API密钥是否正确
`403`	`permission_denied`	权限不足	检查账户权限和余额
`415`	`unsupported_media_type`	不支持的内容类型	使用json或form-data
`500`	`server_error`	服务器内部错误	联系技术支持
`501`	`not_implemented`	功能未实现	该功能暂不可用

错误响应格式

{
  "error": {
    "message": "model is required",
    "type": "invalid_request_error",
    "param": "model",
    "code": "parameter_missing"
  }
}

视频任务错误响应

{
  "id": "video_a1b2c3d4e5f6g7h8",
  "object": "video",
  "status": "failed",
  "error": {
    "message": "视频生成失败：内容安全审核未通过",
    "type": "content_policy_violation"
  }
}

error.type 可能的值

类型	说明
`timeout_error`	生成超时
`quota_exceeded`	配额超限
`rate_limit_error`	速率限制
`invalid_request_error`	请求参数错误
`content_policy_violation`	违反内容政策
`server_error`	服务器错误

⚠️ 注意事项

文件大小限制

类型	建议大小	最大限制
图片	< 5MB	20MB
视频	< 10MB	50MB

媒体格式要求

图片格式

✅ JPEG (.jpg, .jpeg)

✅ PNG (.png)

✅ WebP (.webp)

✅ GIF (.gif)

视频格式

✅ MP4 (.mp4)

✅ MOV (.mov)

✅ AVI (.avi)

✅ WebM (.webm)

✅ MKV (.mkv)

Base64 编码建议

使用场景

小文件（< 1MB）

需要在JSON中传递

无法使用文件上传

注意事项

Base64 会增加约 33% 的数据大小

大文件建议使用 URL 或文件上传

可以包含或不包含 data URI 前缀

URL 要求

✅ 必须可公开访问

✅ 支持 HTTP 和 HTTPS 协议

✅ 建议使用 HTTPS 确保安全

❌ 不支持需要认证的 URL

❌ 不支持本地文件路径

模型选择建议

场景	推荐模型	原因
社交媒体竖屏	`sora-2-portrait-15s`	适合手机观看
横屏电影感	`sora-2-landscape-15s`	电影级宽屏
图片生成	`sora-image-landscape`	横版构图更美观

性能优化建议

文件传输

大文件优先使用 URL

使用 multipart/form-data 上传大文件

避免在 JSON 中使用超大 Base64

并发控制

使用异步轮询获取结果

避免频繁调用状态查询接口

缓存策略

相同参数的请求会返回缓存结果

视频缓存有效期：24小时

如需强制重新生成，修改 prompt

最佳实践

提示词编写

详细描述场景、动作、风格

使用具体的形容词和动词

分镜时每个镜头独立完整描述

避免过于抽象或模糊的描述

错误处理

始终检查响应状态码

实现重试机制（指数退避）

记录错误日志便于排查

处理超时情况（建议 5 分钟）

安全性

妥善保管 API Key

使用环境变量存储密钥

定期轮换 API Key

📋 更新日志

v1.3.0 (2025-12-10)

新增功能

🆕 新增 style_id 参数，支持视频风格设置

✨ 支持 6 种预设风格：festive（节日）、retro（复古）、news（新闻）、selfie（自拍）、handheld（手持）、anime（动漫）

✨ 支持自定义 style_id 字符串

✨ 风格参数对分镜模式和普通视频生成都有效

🎭 新增 sora-2-characters 专用角色创建模型

👤 优化角色创建流程，提供更快更准确的角色识别

🔗 支持 /v1/chat/completions 端点通过 text 类型直接传入图片或视频 URL

⚡ 角色创建处理时间优化至 30s

改进优化

📝 完善文档结构，优先展示高级功能

🎨 美化文档排版，增加可读性

📊 补充完整的 API 端点说明

💡 增加更多实用示例，包括角色创建和 URL 传入方式

📋 添加 URL 传入方式对比表格，方便开发者选择最适合的方式

v1.2.0 (2025-12-05)

新增功能

🆕 新增 input_reference 参数，支持自动识别图片和视频

✨ 支持 multipart/form-data 格式的 input_reference 文件上传

✨ 增强类型检测，支持基于文件扩展名、MIME 类型和 data URI 前缀的智能识别

🎯 新增 /v1/images/generations 端点（OpenAI 标准格式）

🎯 新增 /v1/images/edits 端点（OpenAI 标准格式）

改进优化

🔄 优化媒体文件处理流程

📝 完善错误提示信息

🚀 提升文件上传性能

v1.1.0 (2025-12-03)

新增功能

🎭 角色功能（Character）

🔄 视频 Remix 功能

🎬 分镜模式支持

📐 智能方向检测

改进优化

🔧 优化任务状态管理

📊 改进进度追踪

🛡️ 增强错误处理

v1.0.0 (2025-12-01)

初始版本

🎨 文生图功能

🖼️ 图生图功能

🎬 文生视频功能

🎥 图生视频功能

常见问题 FAQ

Q: 视频生成需要多长时间？

A: 通常 2-5 分钟，具体取决于视频长度和复杂度。

Q: 支持批量生成吗？

A: 支持，建议使用异步方式提交多个任务，然后轮询状态。

Q: 可以取消正在生成的任务吗？

A: 目前暂不支持任务取消，建议等待完成或超时。

Q: 生成的视频有水印吗？

A: 取决于配置，默认支持去除水印。

🔗 相关资源

📖 NewAPI开发文档

🎓 OpenAI官方文档

感谢使用 Sora2API！

如果您觉得这个文档有帮助，请注意保存书签！

文档地址：https://doc.bailian.dev

Sora2 API - 完整接口文档

📚 目录#

🎯 API端点总览#

核心端点#

内容格式支持#

⚡ 高级功能#

🎨 1. 视频风格控制（Style ID）#

🎭 2. 角色功能（Character）#

🎬 3. 分镜模式（Storyboard）#

🔄 4. Remix 功能#

📐 5. 智能方向检测#

🖼️ 6. 智能文件识别（input_reference）#

📝 完整参数说明#

必需参数#

model #

prompt #

可选参数#

style_id #

orientation #

image #

video #

input_reference #

remix_target_id #

size #

🔄 API端点详解#

POST /v1/chat/completions#

POST /v1/videos#

GET /v1/videos/{video_id}#

POST /v1/videos/{video_id}/remix#

GET /v1/videos/{video_id}/content#

POST /v1/images/generations#

POST /v1/images/edits#

GET /v1/models#

💡 使用示例#

示例 1: 文生视频（基础）#

示例 2: 图生视频（使用URL）#

示例 3: 使用风格参数生成视频#

示例 4: 图生视频（表单上传）#

示例 5: 上传文件（自动识别）#

示例 6: 视频 Remix#

示例 7: 仅创建角色（不生成视频）#

示例 8: 仅创建角色（专用模型）#

示例 9: 角色创建并生成视频#

示例 10: 分镜模式生成#

示例 11: OpenAI 通用格式#

11.1 文生视频#

11.2 图生视频（多模态）#

11.3 传入 URL（简化方式）#

11.4 仅创建角色#

11.5 视频分镜#

11.6 创建角色并生成视频#

📊 错误处理#

常见错误码#

错误响应格式#

视频任务错误响应#

⚠️ 注意事项#

文件大小限制#

媒体格式要求#

Base64 编码建议#

URL 要求#

模型选择建议#

性能优化建议#

最佳实践#

📋 更新日志#

v1.3.0 (2025-12-10)#

v1.2.0 (2025-12-05)#

v1.1.0 (2025-12-03)#

v1.0.0 (2025-12-01)#

常见问题 FAQ#

🔗 相关资源#

📚 目录

🎯 API端点总览

核心端点

内容格式支持

⚡ 高级功能

🎨 1. 视频风格控制（Style ID）

🎭 2. 角色功能（Character）

🎬 3. 分镜模式（Storyboard）

🔄 4. Remix 功能

📐 5. 智能方向检测

🖼️ 6. 智能文件识别（input_reference）

📝 完整参数说明

必需参数

`model`

`prompt`

可选参数

`style_id`

`orientation`

`image`

`video`

`input_reference`

`remix_target_id`

`size`

🔄 API端点详解

POST /v1/chat/completions

POST /v1/videos

GET /v1/videos/{video_id}

POST /v1/videos/{video_id}/remix

GET /v1/videos/{video_id}/content

POST /v1/images/generations

POST /v1/images/edits

GET /v1/models

💡 使用示例

示例 1: 文生视频（基础）

示例 2: 图生视频（使用URL）

示例 3: 使用风格参数生成视频

示例 4: 图生视频（表单上传）

示例 5: 上传文件（自动识别）

示例 6: 视频 Remix

示例 7: 仅创建角色（不生成视频）

示例 8: 仅创建角色（专用模型）

示例 9: 角色创建并生成视频

示例 10: 分镜模式生成

示例 11: OpenAI 通用格式

11.1 文生视频

11.2 图生视频（多模态）

11.3 传入 URL（简化方式）

11.4 仅创建角色

11.5 视频分镜

11.6 创建角色并生成视频

📊 错误处理

常见错误码

错误响应格式

视频任务错误响应

⚠️ 注意事项

文件大小限制

媒体格式要求

Base64 编码建议

URL 要求

模型选择建议

性能优化建议

最佳实践

📋 更新日志

v1.3.0 (2025-12-10)

v1.2.0 (2025-12-05)

v1.1.0 (2025-12-03)

v1.0.0 (2025-12-01)

常见问题 FAQ

🔗 相关资源