[!tip]
目前新版本未经过完整测试，如果有bug欢迎反馈

[!warning] 项目地址
GitHub：https://github.com/TheSmallHanCat/sora2api

已实现功能

- RT、ST、AT 解析与刷新机制：

- 默认以 AT (Access Token) 为准。

- 为避免自动刷新导致账号风控，刷新 AT 需要手动点击刷新按钮，支持RT2AT、ST2AT。

- AT：访问https://chatgpt.com/api/auth/session 里的accesstoken就是

ST：在F12控制台抓cookie __Secure-next-auth.session-token

RT：GitHub - qy527145/openai_token: 用于获取Openai / ChatGPT 相关的token

- 示例图

- Token 信息自动获取：

- 添加 Token 后，程序会自动获取邮箱、AT过期时间、订阅类型、Sora2 支持情况、视频生成剩余次数等信息。

- 如果AT即将到期，程序会自动刷新AT（程序已经集成了RT自动填写更新）

- 如果 Token 账号未设置 Sora 用户名，程序会自动生成随机用户名并进行设置。

- 示例图

- 邀请码管理：

- 支持为 Token 获取和激活激活邀请码。

- 示例图

- Sora2 剩余视频生成次数管理：

- 自动更新 Sora2 剩余视频生成次数，在添加token、使用该token均会更新次数。

- 达到上限后自动冷却，并且不会被轮询，到达冷却时间自动解除。

- 去水印功能：

- 默认关闭。支持使用内置接口或者自建去水印解析服务器。

- 参考这里自建去水印服务器教程

- 示例图

- Sora角色功能：

- 请求时在video_url传入视频文件的base64编码

- 如果请求中存在视频，但是没有提示词，则程序仅仅创建Sora角色并公开，最终返回角色名

- 如果请求中存在视频和提示词，则程序使用视频创建Sora角色，使用角色和提示词生成视频，最终返回视频结果并且删除角色

- 分镜功能：

- 在提示词内使用如下格式[时间]提示词 [时间]提示词触发使用

例如[5.0s]猫猫从飞机上跳伞 [5.0s]猫猫降落 [10.0s]猫猫在田野奔跑

或```
[5.0s]猫猫从飞机上跳伞
[5.0s]猫猫降落
[10.0s]猫猫在田野奔跑
```程序会自动解析并且使用分镜模式。

其他功能

- 缓存策略： 默认将图片和视频缓存到本地，超时时间为 600 秒。

- 生成超时策略： 图片默认 600 秒，视频默认 1500 秒。

- 代理支持： 支持 HTTP 和 SOCKS5 代理。

- 功能开关： 支持对指定token开关图片、视频功能

[!note] 使用方法

部署项目

方式一：Docker 部署（推荐）

标准模式（不使用代理）

# 克隆项目
git clone https://github.com/TheSmallHanCat/sora2api.git
cd sora2api
# 启动服务
docker-compose up -d
# 查看日志
docker-compose logs -f
```>


WARP 模式（使用代理）

使用 WARP 代理启动

docker-compose -f docker-compose.warp.yml up -d

查看日志

docker-compose -f docker-compose.warp.yml logs -f
```>

方式二：本地部署

本地部署

# 克隆项目
git clone https://github.com/TheSmallHanCat/sora2api.git
cd sora2api
# 创建虚拟环境
python -m venv venv
# 激活虚拟环境
# Windows
venv\Scripts\activate
# Linux/Mac
source venv/bin/activate
# 安装依赖
pip install -r requirements.txt
# 启动服务
python main.py
```>

如何使用


- **获取模型列表：**
`https://localhost:8000/v1/models`


**图片模型**




模型 |
说明 |
尺寸 |



`sora-image` |
文生图（默认） |
360×360 |

`sora-image-landscape` |
文生图（横屏） |
540×360 |

`sora-image-portrait` |
文生图（竖屏） |
360×540 |



**视频模型**




模型 |
时长 |
方向 |
说明 |



`sora-video-10s` |
10秒 |
横屏 |
图/文/视频生视频 |

`sora-video-15s` |
15秒 |
横屏 |
图/文/视频生视频 |

`sora-video-landscape-10s` |
10秒 |
横屏 |
图/文/视频生视频 |

`sora-video-landscape-15s` |
15秒 |
横屏 |
图/文/视频生视频 |

`sora-video-portrait-10s` |
10秒 |
竖屏 |
图/文/视频生视频 |

`sora-video-portrait-15s` |
15秒 |
竖屏 |
图/文/视频生视频 |




- **API密钥在管理员后台进行设置**，默认为`han1234`

![图片](https://cdn3.ldstatic.com/optimized/4X/5/2/9/5295e108661cc463ca4c4f85d518f27a7cd3fba5_2_345x225.png)

- **使用支持标准 OpenAI 的 Chat 接口进行调用（需要使用流式）：**
可以直接使用chatbox、cherry等客户端对话形式调用，对于传入视频文件创建角色功能，部分客户端可能暂时未适配`input_video`来上传视频文件，具体调用格式参考GitHub - TheSmallHanCat/sora2api: 逆向账号池，支持无水印视频、负载均衡、AT自动刷新、邀请码管理、缓存策略
请求接口：`https://localhost:8000/v1/chat/completions`
使用截图：


示例图

![图片](https://cdn3.ldstatic.com/optimized/4X/1/d/6/1d6726598da61f27509c4da89516e6294fa9d235_2_216x500.jpeg)

[!warning] 其他补充说明

• IP要求： Sora 对 IP 地区和干净程度要求很高。如果添加Token时候Sroa2显示不可用，并且控制台输出Sora is not available in your country，只能更换代理。尽管项目已集成了Warp，但分配的部分ip仍然可能无法使用Sora。

如果跳了 CF 盾，可能是 IP 不干净或者不受支持（例如香港 IP 无法使用 Sora）。

- 新账号用户名： 建议添加自己大号前，提前设置好用户名等信息。因为添加Token时，如果Token未激活过Sora，程序会自动创建用户名。

- 风险提示： 目前项目刚完工，可能存在许多未知 Bug。后续更新可能会更改数据库结构，为避免数据库不兼容，请定期手动备份数据。

[!tip] 致谢

- @tibbar 负责上游API整理、项目部分逻辑规划、去水印服务搭建

- 前端UI参考：GitHub - chenyme/grok2api: 基于 FastAPI 重构的 Grok2API，适配最新的Web调用格式，支持流式对话、图像生成、图像编辑、联网搜索、视频生成、深度思考，支持号池并发调用和自动负载均衡。

- RT转换：GitHub - qy527145/openai_token: 用于获取Openai / ChatGPT 相关的token

^-^ 如果这个项目对你有帮助，请给个赞或Star！

[!note] 最近更新日志

- 2025.11.08：移除视频冷却手动设置、修复图片流式日志、新增无水印解析接口、剩余视频额度获取、视频时长选择、自动冻结解冻无次数的token

- 2025.11.09：修复移动端显示问题、修复sora验证码复制、新增自动为sora账户绑定用户名、视频图片功能独立开关、自动刷新AT、新增缓存开关、优化图片视频输出格式

- 2025.11.16：新增角色功能、独立视频模型时长、修复非流测试输出问题、修复数据库逻辑

- 2025.11.18：新增每日用量统计、图片并发设置、token导入导出、完善token刷新日志输出、修复对话视频参数、修复自动更新时无法根据AT有效期禁用过期token的问题

- 2025.12.03：新增分镜功能、token添加验证，修复统计异常