跳转到主要内容

​
概述

Sora 2 官方直转（官转）是 API易 提供的 OpenAI 官方 API 透明转发服务。与官逆渠道不同，官转直接调用 OpenAI 官方 API，享有更高的稳定性、更精准的指令遵循和更清晰的画质输出。
官转渠道说明：官转是 OpenAI 官方 API 的透明转发，所有请求直接发送到 OpenAI 服务器处理，确保最佳的生成质量和稳定性。

​
官转 vs 官逆对比

对比项官方直转官逆
稳定性99.99% 可用性受风控影响，偶有波动
指令遵循高精准度一般
画质稳定清晰偶现模糊
视频时长4/8/12 秒10/15 秒
价格按秒计费（较高）按次计费（较低）
调用方式仅异步调用同步流式 / 异步调用
推荐异步调用：无论官转还是官逆，都推荐使用异步调用方式，稳定性更好，各种出错情况不计费。

​
核心特性

官方直连

OpenAI 官方 API 透明转发，无中间处理

极致稳定

99.99% 服务可用性，无风控困扰

高精度输出

指令遵循精准，画质稳定清晰

灵活计费

按秒计费，按需使用更经济

​
模型定价

​
sora-2（标准版）

官方模型介绍：platform.openai.com/docs/models/sora-2
分辨率单价4 秒8 秒12 秒
720×1280（竖屏）$0.1/秒$0.4$0.8$1.2
1280×720（横屏）$0.1/秒$0.4$0.8$1.2

​
sora-2-pro（专业版）

官方模型介绍：platform.openai.com/docs/models/sora-2-pro
分辨率单价4 秒8 秒12 秒
720×1280 / 1280×720$0.3/秒$1.2$2.4$3.6
1024×1792 / 1792×1024$0.5/秒$2.0$4.0$6.0
  • 官转渠道按**视频时长（秒）**计费，而非按次计费
  • 异步调用时，生成失败不扣费（如服务器过载返回错误）
  • 视频存储时效为 1 天，请及时下载

​
使用要求

重要：使用官转渠道前，请确保完成以下配置，否则将无法调用。
1

登录控制台

访问 api.apiyi.com 并登录您的账户
2

选择分组：Sora2官转

在 API Key 管理 页面，将分组设置为 Sora2官转
不同分组对应不同的渠道和计费方式，请确保选择正确。
3

设置计费模式：按量计费

在 API Key 设置 中，将计费模式设置为 按量计费
按次计费无法调用官转渠道，必须使用按量计费模式。
4

确保余额充足

官转渠道价格较高，请确保账户余额充足

​
API 调用方式

​
端点地址

https://api.apiyi.com/v1/videos
官方接口文档：platform.openai.com/docs/api-reference/videos/create

​
调用流程（异步三步）

官转渠道仅支持异步调用，需要三个步骤：
  1. 提交请求 → 获取任务 ID
  2. 轮询状态 → 查询生成进度
  3. 下载视频 → 获取最终视频

​
第一步：提交生成请求

​
文生视频

curl -X POST "https://api.apiyi.com/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "一只金毛犬在海滩上奔跑，夕阳西下，金色的阳光洒在海面上",
    "seconds": "8",
    "size": "1280x720"
  }'

​
图生视频（可选）

使用 input_reference 参数上传参考图片，实现图生视频功能。
图片分辨率必须与 size 参数一致，例如 size: "1280x720" 则图片也需要是 1280×720。
curl -X POST "https://api.apiyi.com/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=sora-2" \
  -F "prompt=让这个场景动起来，海浪轻轻拍打沙滩" \
  -F "seconds=8" \
  -F "size=1280x720" \
  -F "input_reference=@/path/to/image.jpg"

​
第二步：轮询任务状态

curl -X GET "https://api.apiyi.com/v1/videos/{task_id}" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
第三步：下载视频

import urllib.request

if video_url:
    urllib.request.urlretrieve(video_url, "output_video.mp4")
    print("视频已保存到 output_video.mp4")

​
请求参数

参数名类型必填说明
modelstring否模型名称：sora-2（默认）或 sora-2-pro
promptstring是视频描述提示词
input_referencefile否可选的参考图片，用于图生视频。仅支持 1 个文件，且图片分辨率必须与视频分辨率一致，否则会报错
secondsstring否视频时长，可选 4/8/12，默认 4
sizestring否输出分辨率，如 720x1280、1280x720、1024x1792、1792x1024，默认 720x1280
图生视频注意：使用 input_reference 参数时，参考图片的分辨率必须与 size 参数指定的视频分辨率完全一致，否则会返回错误：Inpaint image must match the requested width and height

​
响应格式

​
提交请求响应

{
  "id": "video_123",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1712697600,
  "size": "1280x720",
  "seconds": "8",
  "quality": "standard"
}

​
查询状态响应

{
  "id": "video_123",
  "object": "video",
  "model": "sora-2",
  "status": "completed",
  "progress": 100,
  "created_at": 1712697600,
  "size": "1280x720",
  "seconds": "8",
  "quality": "standard",
  "video_url": "https://cdn.example.com/video.mp4"
}

​
状态说明

状态说明
queued任务已提交，排队等待处理
in_progress正在生成视频
completed生成完成，可下载
failed生成失败

​
常见问题

官转（官方直转）：直接调用 OpenAI 官方 API，稳定性高、画质好、指令遵循精准，但价格较高，按秒计费。官逆（官方逆向）：通过逆向工程实现的接口，价格便宜、按次计费，但可能受风控影响，稳定性和画质略有波动。
官转直接对接 OpenAI 官方 API，官方视频生成本身就是异步任务模式。标准版生成一个视频通常需要 3-5 分钟，Pro 版本视复杂程度可能需要 10 分钟。异步模式可以避免长时间连接超时，更加稳定可靠。
官转目前支持 4秒、8秒、12秒 三种时长选项。与官逆的 10/15 秒不同，这是官方 API 的原生支持时长。
API易 提供多档充值加赠活动，详情请查看 充值优惠活动。
异步调用时，生成视频失败均不计费。但也请注意输入内容的合规和合法，避免资源浪费和产生争议。
视频在 CDN 上保存 1 天，请在生成后及时下载到本地保存。过期后视频链接将失效。

​
相关资源

Sora 2 官逆版

价格更低的官逆渠道，按次计费，支持同步流式

Sora 2 异步调用

详细的异步调用教程和最佳实践

充值优惠

查看最新的充值加赠活动

使用场景

查看各种客户端配置教程