OpenAI Sora 2 MCP服务器
用于使用OpenAI Sora 2 API生成视频的模型上下文协议（MCP）服务器。
特性
- 文本转视频：根据文本提示生成视频
- 图像转视频：将图像动画化为视频
- 混音：使用新提示修改现有视频
- 批处理：执行多个具有并发控制的视频生成作业
- 成本估算：在执行批处理作业之前估算成本
需求
- Node.js 18.0.0或更高版本
- 具有第2+级访问权限的OpenAI API密钥（Sora需要10美元以上的信用购买）
安装
npm install openai-sora2-mcp-server或者克隆并在本地构建：
git clone https://github.com/your-repo/openai-sora2-mcp-server.git
cd openai-sora2-mcp-server
npm install
npm run build配置
创建 .env 项目根目录中的文件：
OPENAI_API_KEY=sk-...
DEBUG=false
OUTPUT_DIR=./output
VIDEO_POLL_INTERVAL=15000
VIDEO_MAX_POLL_ATTEMPTS=120用法
MCP 服务器
添加到您的Claude Desktop配置(claude_desktop_config.json):
{
"mcpServers": {
"sora2": {
"command": "npx",
"args": ["sora2-mcp-server"],
"env": {
"OPENAI_API_KEY": "sk-..."
}
}
}
}可用工具
生成视频
从文本提示或图像生成视频。
Parameters:
- prompt (required): Description of the video to generate
- model: "sora-2" (default) or "sora-2-pro"
- size: "1280x720" (default), "1920x1080", "1080x1920", etc.
- seconds: 4/8/12 for sora-2, 10/15/25 for sora-2-pro
- input_reference: Image URL or base64 for image-to-video
- output_path: Path to save the video file混音视频
将现有视频与新提示进行混音。
Parameters:
- prompt (required): New description for the remixed video
- remix_video_id (required): ID of the video to remix
- output_path: Path to save the remixed video获取_视频_状态
检查视频生成作业的状态。
Parameters:
- video_id (required): ID of the video to check列表_视频
列出以前生成的视频。
Parameters:
- limit: Maximum number of videos to return (default: 20)批处理CLI
从配置文件执行多个视频生成作业：
sora2-batch config.json [options]选项
| 选项 | 描述 | |
|---|---|---|
| `--output-dir | ||
| ` | 生成视频的输出目录 | |
| `--format text\ | json` | 输出格式（默认：文本） |
--timeout | 批处理总超时时间（毫秒） | |
--max-concurrent | 最大并发作业数（1-5，默认值：2） | |
--poll-interval | 轮询间隔（默认值：15000） | |
--estimate-only | 仅估算成本而不执行 | |
--help | 显示帮助 |
示例
# Estimate cost
sora2-batch examples/batch-simple.json --estimate-only
# Execute batch
sora2-batch examples/batch-simple.json --output-dir ./output --max-concurrent 3批量配置
{
"jobs": [
{
"prompt": "A cat playing piano in a jazz bar",
"seconds": 8,
"size": "1280x720"
},
{
"prompt": "Ocean waves at sunset",
"seconds": 4,
"size": "1920x1080"
}
],
"output_dir": "./output",
"max_concurrent": 2,
"default_model": "sora-2",
"default_size": "1280x720",
"default_seconds": 4,
"retry_policy": {
"max_retries": 2,
"retry_delay_ms": 1000,
"retry_on_errors": ["rate_limit", "timeout", "429", "503"]
}
}型号和定价
sora-2（标准）
| 持续时间 | 分辨率 | 价格 |
|---|---|---|
| 4秒 | 720便士 | 0.40美元 |
| 8秒 | 720p | 0.80美元 |
| 12秒 | 720便士 | 1.20美元 |
sora-2-pro（高品质）
| 持续时间 | 分辨率 | 价格 |
|---|---|---|
| 10秒 | 720p | 3.00美元 |
| 15秒 | 720p | 4.50美元 |
| 25秒 | 720p | 7.50美元 |
| 10秒 | 1024p | 5.00美元 |
| 25秒 | 1024p | 12.50美元 |
支持的决议
| 宽高比 | 分辨率 |
|---|---|
| 16:9（横向） | 1920x1080、1280x720 |
| 9:16（肖像） | 1080x1920、720x1280 |
| 1:1（正方形） | 1080x1080、480x480 |
api参考
端点
| 操作 | 端点 |
|---|---|
| 生成视频 | POST https://api.openai.com/v1/videos |
| 混音视频 | POST https://api.openai.com/v1/videos/{id}/remix |
| 获取状态 | GET https://api.openai.com/v1/videos/{id} |
| 视频列表 | GET https://api.openai.com/v1/videos |
| 下载中心 | GET https://api.openai.com/v1/videos/{id}/content |
视频状态
| 状态 | 描述 |
|---|---|
queued | 排队等候 |
in_progress | 目前正在处理 |
completed | 生成已完成 |
failed | 生成失败 |
cancelled | 作业已取消 |
许可证
麻省理工学院