Grok2API 是基于 FastAPI 构建的开源 Grok API 代理服务，全面适配 OpenAI 兼容调用格式，支持流式/非流式对话、图像生成编辑、视频生成、工具调用、语音聊天等全功能，号池并发与自动负载均衡一体化，让你轻松将 Grok 能力集成到任何应用。

🎤 引言

在 AI 应用开发中，如何快速接入强大的大语言模型能力是开发者面临的核心问题。Grok 作为 xAI 推出的先进模型，具备强大的推理和多模态能力，但官方 API 接入方式相对封闭。

今天为大家推荐一款开源神器 —— Grok2API！它基于 FastAPI 构建，全面适配 OpenAI 兼容的调用格式，让你可以用熟悉的 OpenAI SDK 方式调用 Grok 的全部能力，包括对话、图像生成、视频生成、工具调用等。

⭐ 核心亮点

1. 全面 OpenAI 兼容

Grok2API 最大的优势是完全兼容 OpenAI API 格式：

  • ✅ 对话接口 - /v1/chat/completions 标准格式
  • ✅ 流式输出 - SSE 流式响应，实时体验
  • ✅ 非流式输出 - 完整 JSON 响应
  • ✅ 工具调用 - Function Calling 支持
  • ✅ 图像生成 - DALL-E 兼容格式
  • ✅ 图像编辑 - 支持图像修改和变体
  • ✅ 视频生成 - 文生视频、图生视频

代码示例：

from openai import OpenAI

client = OpenAI(
    base_url="http://localhost:8000/v1",
    api_key="your-api-key"
)

response = client.chat.completions.create(
    model="grok-2",
    messages=[{"role": "user", "content": "Hello!"}],
    stream=True
)

2. 多模态全功能支持

功能说明
💬 对话流式/非流式对话，支持深度思考
🎨 图像生成文生图，支持多种风格
✏️ 图像编辑图生图、图像变体、局部编辑
🎬 视频生成文生视频、图生视频、超分
🔧 工具调用Function Calling，扩展能力
🎙️ 语音聊天语音输入输出支持

3. 号池并发与负载均衡

  • 多账号支持 - 配置多个 Grok 账号组成号池
  • 自动轮询 - 智能分配请求到不同账号
  • 负载均衡 - 自动监控账号状态，故障自动切换
  • 并发控制 - 精细化并发管理，避免触发限制

4. 一键部署，开箱即用

支持多种部署方式：

部署方式命令
Docker Composedocker compose up -d
Vercel一键部署按钮
Render一键部署按钮
本地运行uv sync && uv run granian ...

📥 安装与使用

Docker Compose 部署（推荐）

# 克隆仓库
git clone https://github.com/chenyme/grok2api
cd grok2api

# 配置环境变量
cp .env.example .env
# 编辑 .env 文件，设置 GROK_API_KEY

# 启动服务
docker compose up -d

本地 Python 运行

# 使用 uv 安装依赖
uv sync

# 启动服务
uv run granian --interface asgi --host 0.0.0.0 --port 8000 --workers 1 main:app

配置说明

关键环境变量：

  • GROK_API_KEY - Grok API 密钥
  • LOG_LEVEL - 日志级别（INFO/DEBUG）
  • DATA_DIR - 数据存储目录
  • SERVER_STORAGE_TYPE - 存储类型（local/mysql/redis/postgresql）

🛠 适用场景

✅ 适合场景

  • AI 应用开发 - 快速接入 Grok 能力到现有应用
  • 多模态应用 - 需要图像/视频生成能力的项目
  • OpenAI 迁移 - 从 OpenAI 迁移到 Grok 的过渡方案
  • 私有化部署 - 需要自托管 API 代理的企业
  • 负载均衡 - 高并发场景下的稳定服务

❌ 不适合场景

  • 完全离线环境（需要 Grok API 访问）
  • 对延迟极度敏感的场景
  • 无 Docker/Python 环境的设备

🔍 与同类工具对比

工具特点Grok2API 优势
官方 Grok API原生支持Grok2API 兼容 OpenAI 格式，迁移成本低
One API多模型聚合Grok2API 专注 Grok，功能更完整
自定义代理自行开发Grok2API 开箱即用，维护成本低

Grok2API 的核心优势：

  • 完全 OpenAI 兼容，现有代码零改动迁移
  • 支持 Grok 全部多模态能力
  • 号池管理，高可用性
  • 开源免费，可自托管

💡 实战示例

图像生成

response = client.images.generate(
    model="grok-image",
    prompt="一只在太空中漂浮的猫，赛博朋克风格",
    size="1024x1024"
)

工具调用

def get_weather(location: str):
    return {"temperature": 25, "condition": "sunny"}

response = client.chat.completions.create(
    model="grok-2",
    messages=[{"role": "user", "content": "北京天气如何？"}],
    tools=[{
        "type": "function",
        "function": {
            "name": "get_weather",
            "parameters": {"location": "string"}
        }
    }]
)

✅ 总结

Grok2API 是一款功能强大的 Grok API 开源代理工具，它解决了 Grok 接入的两大痛点：

  1. 兼容性问题 - 完全 OpenAI 格式兼容，现有应用零改动迁移
  2. 功能完整性 - 支持 Grok 全部多模态能力（对话、图像、视频、工具调用）

推荐指数：⭐⭐⭐⭐⭐

如果你正在使用或计划使用 Grok，Grok2API 是目前最优雅的接入方案。

📌 项目信息