一个完全兼容 OpenAI API 格式的代理服务器,将 OpenAI 格式的请求转换为 Z.AI API 调用。
- OpenAI 格式兼容:兼容 OpenAI API 请求/响应格式,支持流式(SSE)和非流式模式
- 多模型支持:支持
glm-4.6v视觉模型、glm-5与glm-4.7 - 插件兼容:支持 Cline、Roo Code、Kilo Code 等第三方插件
- 运维友好:健康检查、CORS、代理配置、Token 认证、请求重试、可配置日志
cp env_template.txt .env编辑 .env 文件,配置关键参数:
ZAI_TOKEN=your_zai_token # 必须配置
AUTH_TOKEN=sk-123456 # 客户端认证用
LISTEN_PORT=8080
DEBUG_LOGGING=false # 生产环境建议关闭完整配置项见 env_template.txt。
docker-compose up -d # 启动
docker-compose logs -f # 查看日志
docker-compose down # 停止
docker-compose up -d --build # 更新重建pip install -r requirements.txt
python main.py服务默认在 http://localhost:8080 启动。
from openai import OpenAI
client = OpenAI(
base_url="http://localhost:8080/v1",
api_key="sk-123456" # 与 .env 中的 AUTH_TOKEN 一致
)
response = client.chat.completions.create(
model="glm-5",
messages=[{"role": "user", "content": "你好"}]
)如需为 glm-5 或 glm-4.7 显式开启思考模式,可以在请求体中使用以下任一字段:
thinking: {"type": "enabled"}reasoning_effort(值不为none)enable_thinking: true
当多个字段同时存在时,按以下优先级解析:
thinking > reasoning_effort > enable_thinking
| 端点 | 方法 | 说明 |
|---|---|---|
/ |
GET | 服务信息 |
/health |
GET | 健康检查 |
/v1/chat/completions |
POST | 聊天补全(兼容 OpenAI) |
/v1/models |
GET | 模型列表 |
| 模型名称 | Z.AI 后端模型 | 说明 |
|---|---|---|
| glm-4.6v | glm-4.6v | 视觉旗舰模型 |
| glm-5 | glm-5 | 最新旗舰模型 |
| glm-4.7 | glm-4.7 | 与 glm-5 共享同一套思考开关规则 |
兼容性说明:
- 公开模型名以
/v1/models返回结果为准:glm-4.6v、glm-5、glm-4.7 - 为兼容旧客户端,请求中仍接受
GLM-4.6V、GLM-5、GLM-5-Think - 其中
GLM-5-Think在未显式传入新开关字段时,会默认按思考模式处理