Sora2API：一个将sora账号转为API服务接口的免费开源系统

镜像简介

本镜像是开源的Sora2API系统，支持将Sora2账号快速转换为标准API服务接口，实现便捷的远程调用。该系统一键部署，支持无显卡模式运行，免费使用且无额外水印与账号限制。适用于开发者集成、无GPU环境部署及需要稳定API接口的视频生成场景，大幅降低Sora2服务的使用门槛与接入成本。

学习请到千人qq群咨询 本人仅提供一个项目研究不提供技术支持，谢谢！

bug反馈可以加入科哥专属群交流➕ 广告勿进！​

​

科哥在UCloud镜像列表【不断更新中】：

• https://kege-aigc.feishu.cn/docx/L3FVdQl7kom8Ckx7QiicQj2VnEd

运行截图：

运行方法一：

任意选择一个显卡，开机之后关闭，然后选择实例 - 更多 - 无卡模式 开机！

在控制台打开【webui】即可进入使用界面，进行操作；

【全部开机即用！】涉及到sora2账号的联系微信：312088415

运行方法二：打开命令行终端，输入指令，然后回车：

cd /root && bash run.sh

查看进程： ps -ef |grep python

终止进程： kill -9 pid

• sora2api系统源码：
• https://github.com/kegeai888/sora2api-WebUI

---

Sora2API 用户使用手册

📖 目录

1. 快速开始
2. 管理后台使用
3. Token 管理
4. API 调用指南
5. 生成面板使用
6. 常见问题

---

快速开始

访问地址

• 管理后台: http://localhost:8000
• 默认账号: admin
• 默认密码: admin

⚠️ 重要: 首次登录后请立即修改密码！

---

管理后台使用

登录系统

1. 访问 http://localhost:8000
2. 输入账号密码（默认都是 admin）
3. 点击"登录"按钮

主界面说明

登录后进入管理控制台，包含四个主要功能模块：

1️⃣ Token 管理

管理 Sora 账号的 Access Token，支持添加、编辑、删除、刷新等操作。

2️⃣ 系统配置

配置系统参数，包括代理、超时时间、缓存等。

3️⃣ 请求日志

查看所有 API 请求的详细日志，便于调试和监控。

4️⃣ 生成面板

可视化生成界面，支持文生图、图生图、文生视频、图生视频等功能。

---

Token 管理

统计卡片说明

• Token 总数: 系统中配置的 Token 总数
• 活跃 Token: 当前可用的 Token 数量
• 今日图片/总图片: 今日生成的图片数 / 历史总图片数
• 今日视频/总视频: 今日生成的视频数 / 历史总视频数
• 今日错误/总错误: 今日错误次数 / 历史总错误次数

添加 Token

方式一：单个添加

1. 点击"添加 Token"按钮
2. 填写以下信息：
   • Access Token (AT): 必填，从 Sora 网站获取
   • Refresh Token (RT): 可选，用于自动刷新 AT
   • Session Token (ST): 可选，用于自动刷新 AT
   • 账号类型: 选择 Free 或 Pro
   • 备注: 可选，便于识别
3. 点击"保存"

方式二：批量导入

1. 点击"批量导入"按钮
2. 按照格式填写（每行一个 Token）：

   access_token|refresh_token|session_token|plan_type|remark
   

   示例：

   eyJhbGc...xyz|frt-xxx|st-xxx|free|测试账号1
   eyJhbGc...abc|frt-yyy|st-yyy|chatgpt_pro|Pro账号1
   

3. 点击"导入"

Token 状态说明

• 🟢 活跃: Token 正常可用
• 🔴 禁用: Token 被手动禁用或自动禁用（401 错误）
• ⏰ 即将过期: Token 距离过期不足 24 小时
• ❌ 已过期: Token 已过期，需要刷新

Token 操作

刷新 Token

• 单个刷新: 点击 Token 行的"刷新"按钮
• 批量刷新: 勾选多个 Token，点击"批量操作" → "批量刷新"
• 自动刷新: 开启"自动刷新 AT"开关，系统每天 00:00 自动刷新

编辑 Token

1. 点击 Token 行的"编辑"按钮
2. 修改信息（AT、RT、ST、备注等）
3. 点击"保存"

禁用/启用 Token

• 单个操作: 点击 Token 行的"禁用"或"启用"按钮
• 批量操作: 勾选多个 Token，点击"批量操作" → "批量禁用/启用"

删除 Token

• 单个删除: 点击 Token 行的"删除"按钮
• 批量删除: 勾选多个 Token，点击"批量操作" → "批量删除"

状态筛选

点击"筛选"按钮，可以按状态筛选 Token：

• 全部
• 活跃
• 禁用
• 即将过期
• 已过期

---

系统配置

基础配置

API Key 管理

• 当前 API Key: 用于调用 API 的密钥
• 修改方法: 点击"修改 API Key"，输入新密钥

管理员账号

• 修改密码: 点击"修改密码"，输入旧密码和新密码

代理配置

启用代理

1. 开启"启用代理"开关
2. 填写代理地址，格式：
   • HTTP 代理: http://127.0.0.1:7890
   • SOCKS5 代理: socks5://127.0.0.1:7890
3. 点击"保存"

POW 代理配置（可选）

用于 Sentinel Token 获取，支持独立配置：

• POW 代理地址: 独立的代理地址
• 用途: 仅用于 Playwright 获取 Sentinel Token

生成配置

超时时间设置

• 图片生成超时: 默认 300 秒（5 分钟）
• 视频生成超时: 默认 3000 秒（50 分钟）

根据网络情况和账号类型调整：

• Free 账号：建议使用默认值
• Pro 账号：可适当增加视频超时时间

任务重试配置

• 启用任务重试: 开启后，失败任务自动重试
• 最大重试次数: 默认 3 次
• 401 自动禁用: 开启后，遇到 401 错误自动禁用 Token

缓存配置

启用缓存

1. 开启"启用缓存"开关
2. 设置缓存超时时间（秒）
3. 填写缓存基础 URL（如 http://127.0.0.1:8000）
4. 点击"保存"

作用: 相同的请求直接返回缓存结果，节省配额。

去水印配置

启用去水印

1. 开启"启用去水印"开关
2. 选择解析方式：
   • 第三方解析: 使用外部服务
   • 自定义解析: 使用自己的解析服务
3. 填写解析 URL 和 Token（如需要）
4. 开启"失败回退"：解析失败时返回带水印视频

调用逻辑配置

调用模式

• default: 默认模式，随机选择 Token
• round_robin: 轮询模式，依次使用 Token

并发控制

设置并发数

1. 点击 Token 行的"设置并发"按钮
2. 输入并发数（1-10）
3. 点击"保存"

说明: 控制每个 Token 同时处理的请求数，避免触发限流。

---

API 调用指南

基本信息

• 端点: http://localhost:8000/v1/chat/completions
• 认证: 在请求头中添加 Authorization: Bearer YOUR_API_KEY
• 格式: OpenAI 兼容格式
• 流式: 必须使用流式响应（stream: true）

支持的模型

图片模型

模型	说明	尺寸
gpt-image	文生图（正方形）	360×360
gpt-image-landscape	文生图（横屏）	540×360
gpt-image-portrait	文生图（竖屏）	360×540

视频模型（标准版）

模型	时长	方向
sora2-landscape-10s	10秒	横屏
sora2-landscape-15s	15秒	横屏
sora2-landscape-25s	25秒	横屏
sora2-portrait-10s	10秒	竖屏
sora2-portrait-15s	15秒	竖屏
sora2-portrait-25s	25秒	竖屏

视频模型（Pro 版）

模型	时长	方向	要求
sora2pro-landscape-10s	10秒	横屏	Pro 订阅
sora2pro-landscape-15s	15秒	横屏	Pro 订阅
sora2pro-landscape-25s	25秒	横屏	Pro 订阅
sora2pro-portrait-10s	10秒	竖屏	Pro 订阅
sora2pro-portrait-15s	15秒	竖屏	Pro 订阅
sora2pro-portrait-25s	25秒	竖屏	Pro 订阅

视频模型（Pro HD 版）

模型	时长	方向	要求
sora2pro-hd-landscape-10s	10秒	横屏	Pro 订阅
sora2pro-hd-landscape-15s	15秒	横屏	Pro 订阅
sora2pro-hd-portrait-10s	10秒	竖屏	Pro 订阅
sora2pro-hd-portrait-15s	15秒	竖屏	Pro 订阅

提示词优化模型

模型	扩展级别	时长
prompt-enhance-short-10s	简短	10秒
prompt-enhance-medium-15s	中等	15秒
prompt-enhance-long-20s	详细	20秒

使用示例

1. 文生图

curl -X POST "http://localhost:8000/v1/chat/completions" \
  -H "Authorization: Bearer han1234" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image",
    "messages": [
      {
        "role": "user",
        "content": "一只可爱的小猫咪"
      }
    ],
    "stream": true
  }'

2. 图生图

curl -X POST "http://localhost:8000/v1/chat/completions" \
  -H "Authorization: Bearer han1234" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image",
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "将这张图片变成油画风格"
          },
          {
            "type": "image_url",
            "image_url": {
              "url": "data:image/png;base64,<base64_encoded_image_data>"
            }
          }
        ]
      }
    ],
    "stream": true
  }'

3. 文生视频

curl -X POST "http://localhost:8000/v1/chat/completions" \
  -H "Authorization: Bearer han1234" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora2-landscape-10s",
    "messages": [
      {
        "role": "user",
        "content": "一只小猫在草地上奔跑"
      }
    ],
    "stream": true
  }'

4. 图生视频

curl -X POST "http://localhost:8000/v1/chat/completions" \
  -H "Authorization: Bearer han1234" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora2-landscape-10s",
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "这只猫在跳舞"
          },
          {
            "type": "image_url",
            "image_url": {
              "url": "data:image/png;base64,<base64_encoded_image_data>"
            }
          }
        ]
      }
    ],
    "stream": true
  }'

5. 视频风格

在提示词中使用 {风格ID} 格式：

curl -X POST "http://localhost:8000/v1/chat/completions" \
  -H "Authorization: Bearer han1234" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora2-landscape-10s",
    "messages": [
      {
        "role": "user",
        "content": "{anime}一只小猫在草地上奔跑"
      }
    ],
    "stream": true
  }'

支持的风格:

• festive: 节日风格
• kakalaka: 混沌风格
• news: 新闻风格
• selfie: 自拍风格
• handheld: 手持风格
• golden: 金色风格
• anime: 动漫风格
• retro: 复古风格
• nostalgic: 怀旧风格
• comic: 漫画风格

6. 视频 Remix

在提示词中包含 Remix 分享链接或 ID：

curl -X POST "http://localhost:8000/v1/chat/completions" \
  -H "Authorization: Bearer han1234" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora2-landscape-10s",
    "messages": [
      {
        "role": "user",
        "content": "https://sora.chatgpt.com/p/s_68e3a06dcd888191b150971da152c1f5改成水墨画风格"
      }
    ],
    "stream": true
  }'

7. 视频分镜

使用 [时长s]提示词 格式：

curl -X POST "http://localhost:8000/v1/chat/completions" \
  -H "Authorization: Bearer han1234" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora2-landscape-10s",
    "messages": [
      {
        "role": "user",
        "content": "[5.0s]猫猫从飞机上跳伞 [5.0s]猫猫降落 [10.0s]猫猫在田野奔跑"
      }
    ],
    "stream": true
  }'

8. 角色生成

仅创建角色（不生成视频）：

curl -X POST "http://localhost:8000/v1/chat/completions" \
  -H "Authorization: Bearer han1234" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora2-landscape-10s",
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "video_url",
            "video_url": {
              "url": "data:video/mp4;base64,<base64_encoded_video_data>"
            }
          }
        ]
      }
    ],
    "stream": true
  }'

创建角色并生成视频：

curl -X POST "http://localhost:8000/v1/chat/completions" \
  -H "Authorization: Bearer han1234" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora2-landscape-10s",
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "video_url",
            "video_url": {
              "url": "data:video/mp4;base64,<base64_encoded_video_data>"
            }
          },
          {
            "type": "text",
            "text": "角色做一个跳舞的动作"
          }
        ]
      }
    ],
    "stream": true
  }'

9. 提示词优化

curl -X POST "http://localhost:8000/v1/chat/completions" \
  -H "Authorization: Bearer han1234" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "prompt-enhance-medium-10s",
    "messages": [
      {
        "role": "user",
        "content": "猫猫"
      }
    ],
    "stream": true
  }'

---

生成面板使用

界面说明

生成面板提供可视化操作界面，无需编写代码即可生成图片和视频。

左侧：角色卡

• 显示已创建的角色
• 支持搜索、筛选
• 拖拽角色到生成区域

中间：生成区域

• 选择模型（图片/视频）
• 输入提示词
• 上传素材（图片/视频）
• 设置参数（风格、时长等）

右侧：任务列表

• 查看任务进度
• 预览生成结果
• 下载/分享

使用流程

文生图

1. 选择图片模型（如 gpt-image）
2. 输入提示词（如"一只可爱的小猫咪"）
3. 点击"生成"按钮
4. 等待生成完成，在右侧查看结果

图生图

1. 选择图片模型
2. 上传参考图片（拖拽或点击上传）
3. 输入提示词（如"变成油画风格"）
4. 点击"生成"按钮

文生视频

1. 选择视频模型（如 sora2-landscape-10s）
2. 输入提示词（如"一只小猫在草地上奔跑"）
3. 可选：添加风格标签（如 {anime}）
4. 点击"生成"按钮

图生视频

1. 选择视频模型
2. 上传参考图片
3. 输入提示词（如"这只猫在跳舞"）
4. 点击"生成"按钮

角色生成

1. 上传角色视频
2. 系统自动提取角色信息
3. 输入动作提示词（如"跳舞"）
4. 点击"生成"按钮

---

请求日志

日志查看

1. 切换到"请求日志"标签
2. 查看所有 API 请求记录

日志信息

• 时间: 请求时间
• 模型: 使用的模型
• 提示词: 用户输入的提示词
• 状态: 成功/失败
• Token: 使用的 Token（脱敏显示）
• 耗时: 请求处理时间
• 错误信息: 失败原因（如有）

日志筛选

• 按状态筛选（成功/失败）
• 按模型筛选
• 按时间范围筛选

日志导出

点击"导出日志"按钮，下载 CSV 格式日志文件。

---

常见问题

Q1: 登录后提示"Token 无效"？

A: 检查以下几点：

1. Token 是否过期（查看 Token 列表状态）
2. Token 是否被禁用
3. 尝试刷新 Token

Q2: 生成失败，提示"401 Unauthorized"？

A: Token 已失效，解决方法：

1. 手动刷新 Token
2. 如果有 RT 或 ST，系统会自动刷新
3. 如果刷新失败，需要重新获取 Token

Q3: 生成速度很慢？

A: 可能原因：

1. 网络问题：检查代理配置
2. 账号限流：降低并发数
3. 服务器负载高：等待或增加 Token

Q4: 如何获取 Access Token？

A:

1. 登录 https://sora.chatgpt.com
2. 打开浏览器开发者工具（F12）
3. 切换到"网络"标签
4. 刷新页面，查找请求头中的 Authorization 字段
5. 复制 Bearer 后面的内容（即 Access Token）

Q5: Pro 模型提示"需要 Pro 订阅"？

A:

1. 确认账号是否有 ChatGPT Pro 订阅
2. 检查 Token 的账号类型是否设置为 chatgpt_pro
3. 如果是 Free 账号，请使用标准版模型

Q6: 视频生成超时？

A:

1. 增加视频超时时间（系统配置 → 生成配置）
2. Pro 账号建议设置为 5000 秒以上
3. 检查网络连接是否稳定

Q7: 如何批量生成？

A:

1. 使用 API 调用（支持并发）
2. 控制并发数，避免触发限流
3. 建议每个 Token 并发数不超过 3

Q8: 缓存如何工作？

A:

1. 相同的请求（模型 + 提示词 + 素材）会返回缓存结果
2. 缓存有效期可在系统配置中设置
3. 节省配额，提升响应速度

Q9: 去水印功能如何使用？

A:

1. 在系统配置中启用去水印
2. 选择解析方式（第三方或自定义）
3. 填写解析服务地址和 Token
4. 建议开启"失败回退"，确保总能获得视频

Q10: 如何监控系统状态？

A:

1. 查看统计卡片（Token 数量、生成数量、错误数量）
2. 查看请求日志（成功率、耗时）
3. 查看 Token 状态（活跃、禁用、过期）

---

技术支持

技术微信: 312088415 原项目地址: https://github.com/TheSmallHanCat/sora2api 问题反馈: GitHub Issues

---

版权声明

本项目基于 Sora2API 进行二次开发。

原作者: TheSmallHanCat 二次开发: 科哥 开源协议: MIT License

承诺永远开源使用，但需要保留版权信息！

---

最后更新: 2026-02-02