一个将 Z.AI 聊天服务转换为 OpenAI 兼容 API 的 Python 服务器。

• 🔄 OpenAI API 兼容 - 完全兼容 OpenAI Chat Completions API
• 🚀 流式响应支持 - 支持实时流式输出
• 🧠 多模型支持 - 支持 GLM-4.5、思考模式、搜索模式和轻量模式
• 🛠️ 工具调用支持 - 完整的 Function Calling 功能
• 🔐 智能Key处理 - 自动识别特殊格式key，支持下游轮询
• 🌐 Render部署优化 - 专为Render平台优化的部署配置

系统会自动识别形如 70454cb612aa41ea8a04a602940e625f.5Xo9fjl3OX8SB6A1 的特殊格式key：

• 格式要求：32位十六进制 + 点号 + 随机字符串
• 自动处理：匹配特殊格式的key会直接用于下游请求
• 回退机制：不匹配的key会回退到默认认证模式

1. 提取请求中的Authorization Bearer token
2. 检查是否为特殊格式key（32位hex.随机字符串）
3. 特殊格式key → 直接用于下游请求
4. 普通key → 验证固定token或使用匿名模式

1. Fork 本仓库到您的 GitHub 账户
2. 在 Render 控制台中创建新的 Web Service
3. 选择您的仓库
4. 配置环境变量（见下方配置说明）
5. 设置启动命令：bash start.sh
6. 点击创建服务

• ✅ 自动扩展 - 根据负载自动调整实例数量
• ✅ HTTPS 支持 - 自动配置 SSL 证书
• ✅ 持久化存储 - 支持文件系统持久化
• ✅ 健康检查 - 自动监控服务状态
• ✅ 日志聚合 - 集中化日志管理
• ✅ 智能Key路由 - 自动识别并处理特殊格式key

pip install -r requirements.txt

python main.py

docker-compose up -d

curl -X POST "http://localhost:8080/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key" \
  -d '{
    "model": "GLM-4.5",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ],
    "stream": false
  }'

curl -X POST "http://localhost:8080/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 70454cb612aa41ea8a04a602940e625f.5Xo9fjl3OX8SB6A1" \
  -d '{
    "model": "GLM-4.5",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ]
  }'

curl -X POST "http://localhost:8080/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key" \
  -d '{
    "model": "GLM-4.5",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ],
    "stream": true
  }'

1. 端口配置：使用环境变量 PORT，Render会自动分配
2. 启动命令：使用 bash start.sh 确保正确的环境配置
3. Key处理：自动识别特殊格式key，无需额外配置
4. 健康检查：服务会在根路径提供健康检查端点
5. 日志记录：启用DEBUG_LOGGING查看详细运行日志

1. 端口冲突：确保 LISTEN_PORT 或 PORT 环境变量正确设置
2. Key验证失败：检查key格式是否正确，特殊格式为32位hex.随机字符串
3. 上游连接失败：检查 API_ENDPOINT 和网络连接
4. Render部署失败：确保使用 bash start.sh 作为启动命令

设置 DEBUG_LOGGING=true 启用详细日志输出，帮助诊断问题。

MIT License

欢迎提交 Issue 和 Pull Request！