Skip to content

TheSmallHanCat/sora2api

BranchesTags

Repository files navigation

Sora2API

License Python FastAPI Docker

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

✨ 功能特性

核心功能

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

高级特性

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

🚀 快速开始

前置要求

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

方式一：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

首次启动

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

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

快速参考

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

API 调用

基本信息（OpenAI标准格式，需要使用流式）

  • 端点: http://localhost:8000/v1/chat/completions
  • 认证: 在请求头中添加 Authorization: Bearer YOUR_API_KEY
  • 默认 API Key: han1234（建议修改）

支持的模型

图片模型

模型 说明 尺寸
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秒 竖屏 文生视频/图生视频

请求示例

文生图

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

图生图

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

文生视频

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

图生视频

curl -X POST "http://localhost:8000/v1/chat/completions" \
  -H "Authorization: Bearer han1234" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-video-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即可
curl -X POST "http://localhost:8000/v1/chat/completions" \
  -H "Authorization: Bearer han1234" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-video-landscape-10s",
    "messages": [
      {
        "role": "user",
        "content": "https://sora.chatgpt.com/p/s_68e3a06dcd888191b150971da152c1f5改成水墨画风格"
      }
    ]
  }'

视频分镜

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

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

视频角色功能

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

功能说明

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

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

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

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

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

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

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

curl -X POST "http://localhost:8000/v1/chat/completions" \
  -H "Authorization: Bearer han1234" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-video-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
  }'

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:8000/v1/chat/completions",
    headers={
        "Authorization": "Bearer han1234",
        "Content-Type": "application/json"
    },
    json={
        "model": "sora-video-landscape-10s",
        "messages": [
            {
                "role": "user",
                "content": [
                    {
                        "type": "video_url",
                        "video_url": {
                            "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 文件。

🙏 致谢

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

📞 联系方式

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

Star History

Star History Chart

About

逆向账号池，支持无水印视频、负载均衡、AT自动刷新、邀请码管理、缓存策略

Resources

Readme

License

MIT license
Activity

Stars

514 stars

Watchers

0 watching

Forks

167 forks
Report repository

Releases

No releases published

Packages

No packages published

Contributors 2

Languages