走蛙概览
走蛙(ZouWa)是 SCS Agent 协作创新会 · 词元工厂 提供的企业级 AI API 网关,通过统一的 OpenAI 兼容接口,聚合 GPT、Claude、Gemini、DeepSeek 等多种 AI 模型,为开发者和 Agent 应用提供一站式 AI 能力接入。
走蛙是什么
走蛙是一个 AI API 中转与网关平台,基于 sub2api 构建。它允许用户通过一个 API Key 访问多个 AI 模型提供商的服务,提供智能路由、自动故障转移、按量计费、用量统计等企业级功能。
核心优势
- 统一接入:一个 API Key 调用所有已接入的 AI 模型,无需分别申请各平台密钥
- 智能路由:跨多个上游账户智能路由,自动故障转移,告别单点故障
- 按量付费:基于 Token 用量的计费模式,充值即用,无订阅费
- 分组管理:灵活的分组/通道体系,不同分组对应不同模型和费率
- 用量透明:完整的请求日志和用量统计,消费一目了然
- 高并发:支持最高 50 并发请求
支持的 AI 模型
平台架构
用户应用 (Codex / Hermes / OpenClaw / 自定义应用)
│
▼
┌─────────────┐
│ 走蛙 API 网关 │ ← 统一入口,OpenAI 兼容接口
│ (zouwa.top) │
└────────┬────────┘
│
┌─────┼─────┐
▼ ▼ ▼
GPT Claude DeepSeek ... ← 上游 AI 模型提供商
下一步
快速开始
本指南将帮助你在 5 分钟内完成走蛙的注册、密钥创建和第一次 API 调用。
前提条件
注意
走蛙平台目前采用邀请制注册,需要管理员邀请或提供邀请码才能注册账号。请联系 SCS Agent 协作创新会管理员获取邀请。
第一步:注册 / 登录
打开 https://zouwa.top,点击 Sign In 进入登录页面。
输入管理员分配的邮箱和密码,勾选服务条款,点击 Sign In 登录。
提示
首次登录后建议前往 Profile 页面修改密码。
第二步:创建 API 密钥
登录后,在左侧导航栏点击 API Keys。
点击 Create API Key 按钮,填写密钥名称,选择分组。
根据你的需求选择合适的分组:
| 分组名称 | 说明 | 费率倍率 | 适用场景 |
|---|---|---|---|
| 初创会员 VIP Codex 专属线路 | Codex X 专属代码生成通道 | 0.7x | Codex 客户端 |
| Codex 高速通道 | 倍率 0.5,用于 Codex | 0.5x | Codex 高速调用 |
| GPT Plus | GPT Plus 订阅号 | 0.8x | GPT 系列模型 |
| Agent 国产模型 DS | 国产 DeepSeek 模型 | 1x | Agent / DeepSeek 调用 |
选择建议
DeepSeek 选择 同好会专属(AI同好会),Agent 选择 国产DS 分组。
创建成功后,密钥仅显示一次,请立即复制并妥善保存。密钥格式为 sk-xxxxxxxxxxxxxxxx。
第三步:发起第一次 API 调用
使用你创建的 API Key,通过 OpenAI 兼容接口调用模型:
curl -X POST 'https://zouwa.top/v1/chat/completions' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer sk-your-api-key-here' \
-d '{
"model": "gpt-5.4",
"messages": [
{"role": "user", "content": "你好,请介绍一下自己"}
]
}'
from openai import OpenAI
client = OpenAI(
api_key="sk-your-api-key-here",
base_url="https://zouwa.top/v1"
)
response = client.chat.completions.create(
model="gpt-5.4",
messages=[
{"role": "user", "content": "你好,请介绍一下自己"}
]
)
print(response.choices[0].message.content)
验证成功
如果返回了正常的 AI 回复,说明你已经成功接入走蛙平台!接下来可以根据需要配置具体的开发工具。
API 接入信息
| 配置项 | 值 |
|---|---|
| Base URL | https://zouwa.top/v1 |
| API 协议 | OpenAI 兼容(Chat Completions) |
| 认证方式 | Authorization: Bearer sk-xxx |
| 支持端点 | /v1/chat/completions、/v1/messages |
创建 API 密钥
API 密钥是调用走蛙平台 AI 模型的凭证。本页详细介绍如何创建和管理 API 密钥。
创建密钥步骤
访问 https://zouwa.top/dashboard,使用你的账号登录。
在左侧导航栏中点击 API Keys,进入密钥管理页面。
点击页面右上角的 Create API Key(创建密钥)按钮。
在弹出的创建对话框中:
- 名称:为密钥起一个易识别的名称(如 "codex"、"hermes"、"image-gen")
- 分组:选择密钥所属的分组/通道,不同分组对应不同模型和费率
- 额度(可选):设置密钥的使用额度上限
创建成功后,系统会显示完整的 API Key。密钥仅显示一次,请立即复制保存。
密钥管理
在 API Keys 页面,你可以:
- 查看所有已创建的密钥及其状态
- 查看每个密钥的最近使用时间和使用 IP
- 查看密钥的额度使用情况
- 禁用或删除不再需要的密钥
- 设置密钥的 IP 白名单/黑名单
安全提示
请勿将 API Key 泄露给他人或提交到公开代码仓库。如果密钥泄露,请立即在控制台禁用并创建新密钥。
CC Switch 配置
CC Switch(CCS)是一个 AI 模型切换工具,通过配置走蛙 API,可以在 CCS 中便捷地切换和调用不同 AI 模型。
配置步骤
启动 CC Switch(CCS)应用程序。
在 CCS 中添加新的 API 配置,填入以下信息:
| 配置项 | 值 |
|---|---|
| API Base URL | https://zouwa.top/v1 |
| API Key | sk-你的走蛙API密钥 |
| 模型 | 根据分组选择对应模型 ID |
保存配置后,在 CCS 中发送一条测试消息,验证是否能正常调用 AI 模型。
打开 Codex 测试
配置完成后,可以通过 Codex 进行测试:
# 使用 Codex 测试走蛙 API
codex chat --model gpt-5.4 "你好,请用一句话介绍走蛙"
配置成功
如果 Codex 返回了正常的 AI 回复,说明 CC Switch 配置成功!
Codex 配置
将走蛙 API 接入 Codex,使用 AI 辅助编程。
配置方法
Codex 支持通过环境变量或配置文件设置 API 接入信息:
方法一:环境变量
export OPENAI_API_KEY="sk-你的走蛙API密钥"
export OPENAI_BASE_URL="https://zouwa.top/v1"
方法二:配置文件
编辑 Codex 的配置文件(通常在 ~/.codex/config.json):
{
"api_key": "sk-你的走蛙API密钥",
"base_url": "https://zouwa.top/v1",
"model": "gpt-5.4"
}
推荐分组
使用 Codex 时,推荐选择以下分组创建密钥:
- Codex 高速通道(费率 0.5x)— 性价比最高,适合日常 Codex 使用
- 初创会员 VIP Codex 专属线路(费率 0.7x)— Codex X 专属代码生成通道
Hermes 配置
将走蛙 API 接入 Hermes,实现 AI 能力集成。
配置步骤
在走蛙控制台创建一个新的 API Key,名称建议设为 "Hermes",分组选择 Agent 国产模型 DS。
在 Hermes 的配置中,设置 API 连接信息:
API Base URL: https://zouwa.top/v1
API Key: sk-你的Hermes专用密钥
Model: deepseek-chat(或根据分组选择对应模型)
保存配置后,在 Hermes 中发送测试请求,确认能正常调用 AI 模型。
说明
Hermes 使用 Agent 国产模型 DS 分组,费率倍率为 1x,支持 DeepSeek 系列国产大模型。
OpenClaw 配置
将走蛙 API 接入 OpenClaw,使用 AI 辅助能力。
配置步骤
在走蛙控制台创建新的 API Key,根据使用需求选择合适的分组。
在 OpenClaw 的设置中,配置 API 连接信息:
API Base URL: https://zouwa.top/v1
API Key: sk-你的OpenClaw专用密钥
保存配置后,发送测试请求验证连接是否正常。
控制台 Dashboard
走蛙控制台提供了全面的账户管理和用量监控功能。
Dashboard 概览
登录后进入 Dashboard 页面,你可以查看:
模型分布
Dashboard 还提供了模型使用分布图,展示各模型的请求次数、Token 用量和费用占比,帮助你了解消费结构。
最近使用记录
在 Dashboard 底部可以查看最近的 API 调用记录,包括调用的模型、时间、Token 用量和费用。
分组与通道
走蛙通过分组(Group)机制管理不同的 AI 模型通道和费率。每个 API Key 关联一个分组,决定其可用的模型和计费标准。
可用分组
| 分组名称 | ID | 平台 | 费率倍率 | 说明 |
|---|---|---|---|---|
| 初创会员 VIP Codex 专属线路 | 3 | OpenAI | 0.7x | Codex X 专属代码生成通道 |
| Codex 高速通道 | 9 | OpenAI | 0.5x | 倍率 0.5,用于 Codex 高速调用 |
| GPT Plus | 10 | OpenAI | 0.8x | GPT Plus 订阅号,支持图片生成 |
| Agent 国产模型 DS | 13 | OpenAI | 1x | 国产 DeepSeek 模型,支持 Agent 应用 |
分组选择建议
- Codex 开发:选择「Codex 高速通道」(0.5x 费率,最经济)或「初创会员 VIP Codex 专属线路」
- Agent / DeepSeek:选择「Agent 国产模型 DS」(国产模型,1x 费率)
- 图片生成:选择「GPT Plus」(支持图片生成功能)
- 通用调用:根据预算和需求选择合适费率的分组
费率说明
费率倍率表示相对于标准价格的折扣。例如 0.5x 表示按标准价格的 50% 计费。
用量统计
走蛙提供详细的用量统计功能,帮助你追踪每一笔 API 调用的消费。
Usage 页面
在左侧导航栏点击 Usage,进入用量统计页面,可以查看:
- 按时间范围(今天、最近 7 天、最近 30 天等)筛选用量数据
- 按模型维度查看请求次数、Token 用量和费用
- Token 使用趋势图表
- 每次 API 调用的详细记录(时间、模型、Token 数、费用)
统计指标说明
| 指标 | 说明 |
|---|---|
| Requests | API 请求次数 |
| Input Tokens | 输入 Token 数量(发送给模型的文本) |
| Output Tokens | 输出 Token 数量(模型生成的文本) |
| Cache Tokens | 缓存 Token 数量(利用缓存减少费用) |
| Cost | 标准费用(按标准价格计算) |
| Actual Cost | 实际费用(按分组费率倍率计算后的费用) |
| RPM | Requests Per Minute,每分钟请求数 |
| TPM | Tokens Per Minute,每分钟 Token 数 |
管理员指南
本指南面向 SCS Agent 协作创新会 · 词元工厂的管理员,介绍如何管理走蛙平台的用户和设置。
管理员功能概览
走蛙平台的管理员拥有以下管理权限:
- 创建和管理用户账号
- 设置用户分组权限
- 管理分组和通道配置
- 查看全局用量统计
- 管理充值和订单
- 生成邀请码
用户管理
添加用户
走蛙平台当前采用邀请制注册(registration_enabled: false),管理员可以通过以下方式添加用户:
管理员在后台生成邀请码(invitation_code_enabled: true),将邀请码分享给新用户。
新用户访问 https://zouwa.top/login,点击 Sign up 注册,填写邮箱、密码和邀请码。
用户注册后,管理员可以在后台为用户分配分组权限(allowed_groups),控制用户可使用的通道。
用户角色
| 角色 | 说明 |
|---|---|
admin | 管理员,拥有全部管理权限 |
user | 普通用户,可使用 API 和管理自己的密钥 |
分组管理
管理员可以创建和管理分组,每个分组可以配置:
- 分组名称和描述
- 关联的 AI 平台(OpenAI、Anthropic 等)
- 费率倍率(rate_multiplier)
- 日/周/月消费限额
- 是否允许图片生成
- RPM 限制
- 是否为专属分组
充值管理
管理员可以:
- 为用户账户充值
- 生成兑换码(Redeem Code)
- 查看充值记录和订单
- 设置用户余额提醒阈值
注意
管理员操作涉及用户资金和权限,请谨慎操作。建议定期审计用户用量和费用。
API 参考
走蛙提供 OpenAI 兼容的 API 接口,支持 Chat Completions 和 Messages 两种端点。
基础信息
| 配置项 | 值 |
|---|---|
| Base URL | https://zouwa.top/v1 |
| 认证方式 | Authorization: Bearer sk-xxx |
| 协议 | OpenAI 兼容 / Anthropic Messages |
| 内容类型 | application/json |
Chat Completions
OpenAI 兼容的聊天补全接口。
请求
POST /v1/chat/completions
Host: zouwa.top
Content-Type: application/json
Authorization: Bearer sk-your-api-key
{
"model": "gpt-5.4",
"messages": [
{"role": "system", "content": "你是一个有帮助的助手"},
{"role": "user", "content": "你好"}
],
"temperature": 0.7,
"max_tokens": 2000,
"stream": false
}
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型 ID,如 gpt-5.4、deepseek-chat 等 |
messages | array | 是 | 对话消息数组,包含 role 和 content |
temperature | number | 否 | 采样温度,0-2,默认 1 |
max_tokens | integer | 否 | 最大生成 Token 数 |
stream | boolean | 否 | 是否使用流式输出,默认 false |
top_p | number | 否 | 核采样参数,0-1 |
响应
{
"id": "chatcmpl-xxx",
"object": "chat.completion",
"created": 1784965502,
"model": "gpt-5.4",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "你好!我是 AI 助手..."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 20,
"completion_tokens": 50,
"total_tokens": 70
}
}
Messages(Anthropic 兼容)
走蛙同时支持 Anthropic Messages 格式的 API 调用。
POST /v1/messages
Host: zouwa.top
Content-Type: application/json
x-api-key: sk-your-api-key
anthropic-version: 2023-06-01
{
"model": "claude-sonnet-4-20250514",
"max_tokens": 1024,
"messages": [
{"role": "user", "content": "你好"}
]
}
SDK 接入
OpenAI Python SDK
pip install openai
from openai import OpenAI
client = OpenAI(
api_key="sk-your-api-key",
base_url="https://zouwa.top/v1"
)
# 聊天
response = client.chat.completions.create(
model="gpt-5.4",
messages=[{"role": "user", "content": "你好"}]
)
print(response.choices[0].message.content)
# 流式输出
stream = client.chat.completions.create(
model="gpt-5.4",
messages=[{"role": "user", "content": "写一首诗"}],
stream=True
)
for chunk in stream:
if chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")
Anthropic Python SDK
pip install anthropic
import anthropic
client = anthropic.Anthropic(
api_key="sk-your-api-key",
base_url="https://zouwa.top"
)
message = client.messages.create(
model="claude-sonnet-4-20250514",
max_tokens=1024,
messages=[{"role": "user", "content": "你好"}]
)
print(message.content[0].text)
Node.js SDK
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: 'sk-your-api-key',
baseURL: 'https://zouwa.top/v1',
});
const response = await client.chat.completions.create({
model: 'gpt-5.4',
messages: [{ role: 'user', content: '你好' }],
});
console.log(response.choices[0].message.content);
错误码
| 状态码 | 错误码 | 说明 |
|---|---|---|
| 401 | API_KEY_REQUIRED | 缺少 API Key |
| 401 | INVALID_API_KEY | API Key 无效或已禁用 |
| 403 | FORBIDDEN | 无权限访问该分组/模型 |
| 429 | RATE_LIMITED | 请求频率超限 |
| 429 | QUOTA_EXCEEDED | 额度已用完 |
| 500 | UPSTREAM_ERROR | 上游 AI 服务错误 |
| 503 | SERVICE_UNAVAILABLE | 服务暂时不可用 |
可用模型列表
通过 API 获取当前可用的模型列表:
curl 'https://zouwa.top/v1/models' \
-H 'Authorization: Bearer sk-your-api-key'