Skip to main content

方案介绍

当前 Sora2 视频新接入仅官方 API 转发可用。创建令牌规则与官方 API 转发 gpt-image-2 一致:只能选择 Sora2OfficialGPTImage2 Enterprise 分组,并使用按量扣费。旧同步 API、旧异步队列、旧线路模型和角色创建文档已标为过时,仅供历史排查参考。
官方 API 转发(官方 API 转发)是指直接调用 OpenAI 官方 Sora API 并透明转发给用户的方案。与已经过时的”旧线路”(官网旧线路)方案不同,官方 API 转发方案具有更高的稳定性和更精准的指令遵循能力。
什么是官方 API 转发?官方 API 转发是 OpenAI 官方 API 的透明转发服务。您的请求会直接转发到 OpenAI 官方服务器,享受与 OpenAI 官方完全一致的服务质量和稳定性。

方案对比

如何选择?
  • 当前新接入:选择官方 API 转发方案
  • 旧线路文档:仅用于历史排查,不建议新项目继续接入

支持的模型和定价

sora-2(标准模型)

sora-2-pro(高清模型)

以上价格已包含本站服务费。

如何开始使用

令牌创建规则

1

创建令牌

登录 laozhang.ai 控制台,新增令牌,并按上表选择计费模式和分组。
2

配置计费模式

令牌计费模式必须选择 “按量计费”;如果控制台下拉框显示为”按量优先”,就选择”按量优先”。实际消费按官方 API 转发调用量扣费。
Sora 官方 API 转发方案不支持默认分组、旧线路分组或按次计费令牌。请不要选择默认分组、gpt-image-2-vip 所在旧线路分组,或其他旧线路分组。
3

调用 API 生成视频

参考下方完整示例调用 API。

API 参考

基础信息

API 端点

请求参数

支持的分辨率(size 参数)

sora-2:
  • 720x1280(竖屏,默认)
  • 1280x720(横屏)
sora-2-pro:
  • 720x1280(竖屏)
  • 1280x720(横屏)
  • 1024x1792(竖屏高清)
  • 1792x1024(横屏高清)

完整示例

文生视频(cURL)

Step 1: 创建视频生成任务
响应示例:
Step 2: 轮询任务状态
响应示例(进行中):
响应示例(完成):
Step 3: 下载视频

图生视频(cURL)

图生视频功能允许您提供一张参考图片作为视频的第一帧,AI 会基于这张图片生成动态视频。
图片要求
  • 图片分辨率必须与 size 参数匹配(如 size=1280x720,则图片需为 1280×720 像素)
  • 支持格式:JPEG、PNG、WebP
  • 不支持包含真人面孔的图片(会被内容审核系统拒绝)

Python 示例

任务状态说明

轮询建议视频生成通常需要 2-5 分钟。建议每 15-20 秒轮询一次状态,避免过于频繁的请求。

开发文档

官方 API 转发方案完全兼容 OpenAI 官方 API 格式,更多参数和高级用法请参考:

OpenAI Sora 官方指南

视频生成完整指南

OpenAI Videos API

API 接口参考文档

Sora 2 模型文档

sora-2 模型详情

Sora 2 Pro 模型文档

sora-2-pro 模型详情

注意事项

重要限制
  1. 仅支持异步调用:官方 API 转发方案不支持同步 API,所有请求均为异步模式
  2. 仅支持按量扣费:必须选择”按量计费”模式,不支持”按次计费”令牌
  3. 仅支持两个官方兼容分组:创建令牌时只能选择 Sora2OfficialGPTImage2 Enterprise
  4. 图片限制:图生视频不支持包含真人面孔的图片

常见问题

官方 API 转发是直接调用 OpenAI 官方 API 的透明转发;旧线路是历史阶段通过旧网站接入方式实现的旧线路,目前已不作为 Sora2 视频的新接入入口。
OpenAI 官方 Sora API 本身只提供异步调用方式,因此官方 API 转发方案也仅支持异步调用。
官方 API 转发方案支持 OpenAI 官方的 4/8/12 秒时长选项;旧线路方案支持的是官网界面的 10/15 秒时长。
图片分辨率必须与目标视频的 size 参数匹配。例如,如果设置 size=1280x720,则图片必须是 1280×720 像素。支持 JPEG、PNG、WebP 格式,不支持包含真人面孔的图片。