Spaces:

Moge-Row
/

Row-proxy

Paused

App Files Files Community

Row-proxy / README.md

Moge-Row

add gif

3af2cb4 about 1 month ago

preview code

raw

history blame contribute delete

12.9 kB

metadata

title: Row Proxy
emoji: 🚀
colorFrom: green
colorTo: gray
sdk: docker
pinned: false

zai-proxy

zai-proxy 是一个基于 Go 语言的代理服务，将 z.ai 网页聊天转换为 OpenAI API 和 Anthropic Messages API 兼容格式。用户使用自己的 z.ai token 或 free 匿名令牌进行调用。

功能特性

OpenAI /v1/chat/completions 兼容
Anthropic /v1/messages 兼容（支持 Claude SDK 直连）
支持流式 (SSE) 和非流式响应
支持多种 GLM 模型，Claude 模型名自动映射
支持思考模式 (thinking)
支持联网搜索模式 (search)
支持工具/函数调用 (function calling)
支持多模态图片输入
支持匿名 Token（免登录）
自动生成请求签名
自动跟踪前端版本号

快速开始

从源码运行

要求 Go 1.21+：

git clone https://github.com/yurika0211/zai-proxy.git
cd zai-proxy
go mod download
go run main.go

编译为可执行文件：

go build -o zai-proxy .
./zai-proxy

Docker 部署

使用预构建镜像

docker run -d --name zai-proxy -p 8000:8000 ghcr.io/yurika0211/zai-proxy:latest

自定义端口和日志级别：

docker run -d --name zai-proxy \
  -p 8080:8000 \
  -e LOG_LEVEL=debug \
  ghcr.io/yurika0211/zai-proxy:latest

镜像仅支持 linux/amd64 平台。

挂载代理文件（可选）

docker run -d --name zai-proxy \
  -p 8000:8000 \
  -v ./proxies.txt:/app/proxies.txt \
  ghcr.io/yurika0211/zai-proxy:latest

可用镜像标签

标签	说明
`latest`	默认分支的最新构建
`v*`（如 `v1.0.0`）	语义化版本发布
`<commit-sha>`	特定 commit 的构建

自行构建镜像

docker build -t zai-proxy .
docker run -d --name zai-proxy -p 8000:8000 zai-proxy

Docker Compose

services:
  zai-proxy:
    image: ghcr.io/yurika0211/zai-proxy:latest
    ports:
      - "8000:8000"
    environment:
      - LOG_LEVEL=info
    restart: unless-stopped

docker compose up -d

环境变量

变量名	说明	默认值
`PORT`	监听端口	`8000`
`LOG_LEVEL`	日志级别 (`debug` / `info` / `warn` / `error`)	`info`

支持 .env 文件自动加载。

代理池（可选）

在项目根目录放置 proxies.txt 文件，每行一个 SOCKS5 代理，格式：

ip:port:username:password
ip:port

启动时自动加载，每次请求随机选择一个代理。不存在该文件则直连。

获取 z.ai Token

方式一：使用匿名 Token（免登录）

直接使用 free 作为 API key，服务会自动获取匿名 token：

curl http://localhost:8000/v1/chat/completions \
  -H "Authorization: Bearer free" \
  -H "Content-Type: application/json" \
  -d '{"model": "glm-4.7", "messages": [{"role": "user", "content": "hello"}]}'

方式二：使用个人 Token

登录 https://chat.z.ai
打开浏览器开发者工具 (F12)
切换到 Application/Storage 标签
在 Cookies 中找到 token 字段
复制其值作为 API 调用的 Authorization

API 端点

`GET /v1/models`

返回可用模型列表（OpenAI 兼容格式）。

`POST /v1/chat/completions`

OpenAI 兼容的聊天补全接口。

认证方式： Authorization: Bearer <token> 或 x-api-key: <token>

curl http://localhost:8000/v1/chat/completions \
  -H "Authorization: Bearer YOUR_ZAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-4.7",
    "messages": [{"role": "user", "content": "hello"}],
    "stream": true
  }'

`POST /v1/messages`

Anthropic Messages API 兼容接口，可直接使用 Anthropic SDK 连接。

认证方式： x-api-key: <token> 或 Authorization: Bearer <token>

curl http://localhost:8000/v1/messages \
  -H "x-api-key: free" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "hello"}],
    "stream": true
  }'

支持的 Anthropic 特性：

system 字段（字符串或内容块数组）
thinking 推理模式（{"type": "enabled"}）
tools / tool_choice 工具调用
流式 SSE 事件（message_start / content_block_delta / message_stop 等）
非流式 JSON 响应

支持的模型

GLM 模型

模型名称	上游模型	说明
`glm-4.5`	0727-360B-API
`glm-4.6`	GLM-4-6-API-V1
`glm-4.7`	glm-4.7
`glm-5`	glm-5	最新
`glm-4.5-v`	glm-4.5v	视觉
`glm-4.6-v`	glm-4.6v	视觉（最新）
`glm-4.5-air`	0727-106B-API	轻量

Claude 模型名映射

通过 /v1/messages 端点使用 Claude 模型名时，会自动映射到对应的 GLM 模型：

Claude 模型	映射到	备注
`claude-opus-4-6`	glm-4.7	自动启用 thinking
`claude-opus-4-5-20250514`	glm-4.7	自动启用 thinking
`claude-sonnet-4-6`	glm-4.7
`claude-sonnet-4-5-20241022`	glm-4.7
`claude-haiku-4-5`	glm-4.5-air
`claude-haiku-4-5-20251001`	glm-4.5-air
`claude-3-5-sonnet-20241022`	glm-4.7
`claude-3-5-haiku-20241022`	glm-4.5-air

Opus 系列模型始终自动启用 thinking 模式。未识别的模型名会回退到 glm-4.7。

模型标签

模型名称支持以下后缀标签（可组合使用，顺序不限）：

标签	说明
`-thinking`	启用思考模式，响应包含 `reasoning_content` 字段
`-search`	启用联网搜索，搜索结果自动转换为 markdown 引用
`-tools`	自动注入内置工具定义，模型可进行函数调用

组合示例：

glm-4.7-thinking
glm-4.7-search
glm-4.7-thinking-search
glm-4.7-tools
glm-4.7-tools-thinking
glm-5-thinking
glm-5-tools

使用示例

多模态请求

{
  "model": "glm-4.6-v",
  "messages": [
    {
      "role": "user",
      "content": [
        {"type": "text", "text": "描述这张图片"},
        {"type": "image_url", "image_url": {"url": "https://example.com/image.jpg"}}
      ]
    }
  ]
}

支持的图片格式：

HTTP/HTTPS URL
Base64 编码 (data:image/jpeg;base64,...)

Anthropic SDK (Python)

import anthropic

client = anthropic.Anthropic(
    api_key="free",
    base_url="http://localhost:8000",
)

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "hello"}],
)
print(message.content[0].text)

Anthropic SDK 思考模式

message = client.messages.create(
    model="claude-opus-4-6",
    max_tokens=8192,
    thinking={"type": "enabled", "budget_tokens": 4096},
    messages=[{"role": "user", "content": "解释量子纠缠"}],
)

for block in message.content:
    if block.type == "thinking":
        print("思考:", block.thinking)
    elif block.type == "text":
        print("回答:", block.text)

工具调用 (Function Calling)

内置工具

使用 -tools 后缀时，代理会自动注入以下 6 个内置工具定义：

工具名	描述	主要参数
`get_current_time`	获取当前时间	`timezone`, `format`
`calculate`	执行数学计算	`expression`
`search_web`	搜索网络信息	`query`, `num_results`
`query_database`	执行 SQL 查询	`sql`, `database`
`file_operations`	文件读写列表	`operation`, `path`, `content`
`call_external_api`	调用外部 API	`url`, `method`, `headers`, `body`

基本调用

curl http://localhost:8000/v1/chat/completions \
  -H "Authorization: Bearer YOUR_ZAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-4.7-tools",
    "messages": [{"role": "user", "content": "现在几点了？"}],
    "stream": true
  }'

模型会返回 tool_calls（finish_reason 为 "tool_calls"），由客户端自行执行工具并将结果发回。

多轮调用流程

第1轮：用户提问 → 模型返回 tool_calls
第2轮：发送工具执行结果 → 模型生成最终回答

curl http://localhost:8000/v1/chat/completions \
  -H "Authorization: Bearer YOUR_ZAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-4.7-tools",
    "messages": [
      {"role": "user", "content": "现在几点了？"},
      {"role": "assistant", "content": "", "tool_calls": [
        {"id": "call_xxx", "type": "function", "function": {"name": "get_current_time", "arguments": "{}"}}
      ]},
      {"role": "tool", "tool_call_id": "call_xxx", "content": "{\"time\": \"2026-03-14 15:30:00\"}"}
    ],
    "stream": true
  }'

自定义工具

也可以不使用 -tools 后缀，直接在请求中传入 tools 字段（标准 OpenAI 格式）：

{
  "model": "glm-4.7",
  "messages": [{"role": "user", "content": "北京天气怎么样？"}],
  "tools": [{
    "type": "function",
    "function": {
      "name": "get_weather",
      "description": "获取天气信息",
      "parameters": {
        "type": "object",
        "properties": {
          "city": {"type": "string", "description": "城市名称"}
        },
        "required": ["city"]
      }
    }
  }],
  "tool_choice": "auto"
}

tool_choice 支持：

"auto" — 模型自行决定是否调用工具
"required" — 强制调用工具
"none" — 禁用工具调用
{"type": "function", "function": {"name": "xxx"}} — 强制调用指定工具

两者可混合使用：-tools 模型名 + 自定义 tools 字段。客户端自带的同名工具优先，不会被内置工具覆盖。

Anthropic 格式工具调用

通过 /v1/messages 端点同样支持工具调用：

curl http://localhost:8000/v1/messages \
  -H "x-api-key: free" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "北京天气怎么样？"}],
    "tools": [{
      "name": "get_weather",
      "description": "获取天气信息",
      "input_schema": {
        "type": "object",
        "properties": {
          "city": {"type": "string", "description": "城市名称"}
        },
        "required": ["city"]
      }
    }]
  }'

tool_choice 映射关系：

Anthropic	OpenAI 等价
`{"type": "auto"}`	`"auto"`
`{"type": "any"}`	`"required"`
`{"type": "none"}`	`"none"`
`{"type": "tool", "name": "xxx"}`	`{"type": "function", ...}`

项目结构

zai-proxy/
├── main.go                     # 入口，路由注册
├── internal/
│   ├── auth/                   # 认证与签名
│   │   ├── anonymous.go        # 匿名 token 获取
│   │   ├── jwt.go              # JWT 解码
│   │   └── signature.go        # HMAC-SHA256 请求签名
│   ├── config/                 # 配置加载 (.env)
│   ├── filter/                 # 响应处理过滤器
│   │   ├── prompttool.go       # 提取 prompt 注入的 tool call
│   │   ├── toolcall.go         # 解析 JSON 格式的 tool call
│   │   ├── thinking.go         # 思考/推理内容处理
│   │   └── search.go           # 搜索结果引用转换
│   ├── handler/                # HTTP 处理器
│   │   ├── chat.go             # /v1/chat/completions
│   │   ├── anthropic.go        # /v1/messages
│   │   └── models.go           # /v1/models
│   ├── logger/                 # 日志系统
│   ├── model/                  # 类型定义
│   │   ├── types.go            # OpenAI 兼容类型
│   │   ├── anthropic.go        # Anthropic API 类型
│   │   └── mapping.go          # 模型名映射与解析
│   ├── proxy/                  # SOCKS5 代理池
│   │   └── pool.go             # 代理加载与随机选择
│   ├── tools/                  # 内置工具定义
│   │   ├── builtin.go          # 6 个内置工具
│   │   └── prompt.go           # 工具系统提示词构建
│   ├── upstream/               # 上游 z.ai 客户端
│   │   ├── client.go           # 请求构建与发送
│   │   └── upload.go           # 图片上传
│   └── version/                # 前端版本号跟踪
├── scripts/
│   └── test_tool_call.sh       # 工具调用集成测试
├── Dockerfile
└── .github/workflows/          # CI/CD