CoolFace
Apppublic

o3sky/sora2api

sourceHugging Faceupdated 9mo agoView on Hugging Face
0likes
App README

Sora2API

<div align="center">

![License](LICENSE) ![Python](https://www.python.org/) ![FastAPI](https://fastapi.tiangolo.com/) ![Docker](https://www.docker.com/)

一个功能完整的 OpenAI 兼容 API 服务，为 Sora 提供统一的接口

</div>

✨ 功能特性

核心功能

  • —🎨 文生图 - 根据文本描述生成图片
  • —🖼️ 图生图 - 基于上传的图片进行创意变换
  • —🎬 文生视频 - 根据文本描述生成视频
  • —🎥 图生视频 - 基于图片生成相关视频
  • —📊 多尺寸支持 - 横屏、竖屏等多种规格
  • —🎭 视频角色功能 - 创建角色，生成角色视频
  • —🎬 Remix 功能 - 基于已有视频继续创作
  • —🎥 分镜功能 - 支持生成分镜视频

高级特性

  • —🔐 Token 管理 - 支持多 Token 管理和轮询负载均衡
  • —🌐 代理支持 - 支持 HTTP 和 SOCKS5 代理
  • —📝 详细日志 - 完整的请求/响应日志记录
  • —🔄 异步处理 - 高效的异步任务处理
  • —💾 数据持久化 - SQLite 数据库存储
  • —🎯 OpenAI 兼容 - 完全兼容 OpenAI API 格式
  • —🛡️ 安全认证 - API Key 验证和权限管理
  • —📱 Web 管理界面 - 直观的管理后台

🚀 快速开始

前置要求

  • —Docker 和 Docker Compose（推荐）
  • —或 Python 3.8+

方式一：Docker 部署（推荐）

标准模式（不使用代理）
bash
# 克隆项目
git clone https://github.com/TheSmallHanCat/sora2api.git
cd sora2api

# 启动服务
docker-compose up -d

# 查看日志
docker-compose logs -f
WARP 模式（使用代理）
bash
# 使用 WARP 代理启动
docker-compose -f docker-compose.warp.yml up -d

# 查看日志
docker-compose -f docker-compose.warp.yml logs -f

方式二：本地部署

bash
# 克隆项目
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

首次启动

服务启动后，访问管理后台进行初始化配置：

  • —地址: http://localhost:7860
  • —用户名: admin
  • —密码: admin

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

快速参考

功能模型说明
文生图gpt-image*使用 content 为字符串
图生图gpt-image*使用 content 数组 + image_url
文生视频sora2-*使用 content 为字符串
图生视频sora2-*使用 content 数组 + image_url
视频风格sora2-*在提示词中使用 {风格ID} 格式,如 {anime}提示词
创建角色sora2-*使用 content 数组 + video_url
角色生成视频sora2-*使用 content 数组 + video_url + 文本
Remixsora2-*在 content 中包含 Remix ID
视频分镜sora2-*在 content 中使用``[时长s]提示词``格式触发

API 调用

基本信息（OpenAI标准格式，需要使用流式）
  • —端点: http://localhost:7860/v1/chat/completions
  • —认证: 在请求头中添加 Authorization: Bearer YOUR_API_KEY
  • —默认 API Key: han1234（建议修改）
支持的模型

图片模型

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

视频模型

标准版（Sora2）

模型时长方向说明
sora2-landscape-10s10秒横屏文生视频/图生视频
sora2-landscape-15s15秒横屏文生视频/图生视频
sora2-landscape-25s25秒横屏文生视频/图生视频
sora2-portrait-10s10秒竖屏文生视频/图生视频
sora2-portrait-15s15秒竖屏文生视频/图生视频
sora2-portrait-25s25秒竖屏文生视频/图生视频

Pro 版（需要 ChatGPT Pro 订阅）

模型时长方向说明
sora2pro-landscape-10s10秒横屏Pro 质量文生视频/图生视频
sora2pro-landscape-15s15秒横屏Pro 质量文生视频/图生视频
sora2pro-landscape-25s25秒横屏Pro 质量文生视频/图生视频
sora2pro-portrait-10s10秒竖屏Pro 质量文生视频/图生视频
sora2pro-portrait-15s15秒竖屏Pro 质量文生视频/图生视频
sora2pro-portrait-25s25秒竖屏Pro 质量文生视频/图生视频

Pro HD 版（需要 ChatGPT Pro 订阅，高清质量）

模型时长方向说明
sora2pro-hd-landscape-10s10秒横屏Pro 高清文生视频/图生视频
sora2pro-hd-landscape-15s15秒横屏Pro 高清文生视频/图生视频
sora2pro-hd-portrait-10s10秒竖屏Pro 高清文生视频/图生视频
sora2pro-hd-portrait-15s15秒竖屏Pro 高清文生视频/图生视频
注意： Pro 系列模型需要 ChatGPT Pro 订阅（plan_type: "chatgpt_pro"）。如果没有 Pro 账号，请求这些模型会返回错误。
请求示例

文生图

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

图生图

bash
curl -X POST "http://localhost:7860/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
  }'

文生视频

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

图生视频

bash
curl -X POST "http://localhost:7860/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
  }'

视频Remix（基于已有视频继续创作）

  • —提示词内包含remix分享链接或id即可
bash
curl -X POST "http://localhost:7860/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
  }'

视频分镜

  • —示例触发提示词：
[5.0s]猫猫从飞机上跳伞 [5.0s]猫猫降落 [10.0s]猫猫在田野奔跑```
* 或

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

curl -X POST "http://localhost:7860/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 }'


### 视频风格功能

Sora2API 支持**视频风格**功能，可以为生成的视频应用预设风格。

#### 使用方法

在提示词中使用 `{风格ID}` 格式指定风格，系统会自动提取并应用该风格。

#### 支持的风格

| 风格ID | 显示名称 | 说明 |
|--------|----------|------|
| `festive` | Festive | 节日风格 |
| `kakalaka` | 🪭👺 | 混沌风格 |
| `news` | News | 新闻风格 |
| `selfie` | Selfie | 自拍风格 |
| `handheld` | Handheld | 手持风格 |
| `golden` | Golden | 金色风格 |
| `anime` | Anime | 动漫风格 |
| `retro` | Retro | 复古风格 |
| `nostalgic` | Vintage | 怀旧风格 |
| `comic` | Comic | 漫画风格 |

#### 示例

**使用动漫风格生成视频**

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


**使用复古风格生成视频**

curl -X POST "http://localhost:7860/v1/chat/completions" \ -H "Authorization: Bearer han1234" \ -H "Content-Type: application/json" \ -d '{ "model": "sora2-landscape-10s", "messages": [ { "role": "user", "content": "{retro}城市街道夜景" } ], "stream": true }'


**在Remix中使用风格**

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


**注意事项**
- 风格标记 `{风格ID}` 可以放在提示词的任意位置
- 系统会自动提取风格ID并从提示词中移除风格标记
- 如果不指定风格，将使用默认风格生成

### 视频角色功能

Sora2API 支持**视频角色生成**功能。

#### 功能说明

- **角色创建**: 如果只有视频，无prompt，则生成角色自动提取角色信息，输出角色名
- **角色生成**: 有视频、prompt，则上传视频创建角色，使用角色和prompt进行生成，输出视频

#### API调用（OpenAI标准格式，需要使用流式）

**场景 1: 仅创建角色（不生成视频）**

上传视频提取角色信息，获取角色名称和头像。

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


**场景 2: 创建角色并生成视频**

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

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


#### Python 代码示例

import requests import base64

读取视频文件并编码为 Base64

with open("video.mp4", "rb") as f: video_data = base64.b64encode(f.read()).decode("utf-8")

仅创建角色

response = requests.post( "http://localhost:7860/v1/chat/completions", headers={ "Authorization": "Bearer han1234", "Content-Type": "application/json" }, json={ "model": "sora2-landscape-10s", "messages": [ { "role": "user", "content": [ { "type": "videourl", "videourl": { "url": f"data:video/mp4;base64,{video_data}" } } ] } ], "stream": True }, stream=True )

处理流式响应

for line in response.iter_lines(): if line: print(line.decode("utf-8"))


---

## 📄 许可证

本项目采用 MIT 许可证。详见 [LICENSE](LICENSE) 文件。

---

## 🙏 致谢

感谢所有贡献者和使用者的支持！

---

## 📞 联系方式

- 提交 Issue：[GitHub Issues](https://github.com/TheSmallHanCat/sora2api/issues)
- 讨论：[GitHub Discussions](https://github.com/TheSmallHanCat/sora2api/discussions)

---

**⭐ 如果这个项目对你有帮助，请给个 Star！**

## Star History

[![Star History Chart](https://api.star-history.com/svg?repos=TheSmallHanCat/sora2api&type=date&legend=top-left)](https://www.star-history.com/#TheSmallHanCat/sora2api&type=date&legend=top-left)