走蛙概览

走蛙（ZouWa）是 SCS Agent 协作创新会 · 词元工厂 提供的企业级 AI API 网关，通过统一的 OpenAI 兼容接口，聚合 GPT、Claude、Gemini、DeepSeek 等多种 AI 模型，为开发者和 Agent 应用提供一站式 AI 能力接入。

走蛙是什么

走蛙是一个 AI API 中转与网关平台，基于 sub2api 构建。它允许用户通过一个 API Key 访问多个 AI 模型提供商的服务，提供智能路由、自动故障转移、按量计费、用量统计等企业级功能。

走蛙平台首页
走蛙平台首页 — 懂你的 Coding 搭子

核心优势

  • 统一接入：一个 API Key 调用所有已接入的 AI 模型，无需分别申请各平台密钥
  • 智能路由：跨多个上游账户智能路由，自动故障转移，告别单点故障
  • 按量付费：基于 Token 用量的计费模式，充值即用，无订阅费
  • 分组管理：灵活的分组/通道体系，不同分组对应不同模型和费率
  • 用量透明：完整的请求日志和用量统计，消费一目了然
  • 高并发：支持最高 50 并发请求

支持的 AI 模型

GPT
GPT 系列
GPT-4o、GPT-5 等 OpenAI 模型 已支持
Claude
Claude 系列
Claude Sonnet、Claude Opus 等 已支持
Gemini
Gemini 系列
Google Gemini 系列模型 已支持
DeepSeek
DeepSeek 系列
DeepSeek 国产大模型 已支持

平台架构

架构示意 
用户应用 (Codex / Hermes / OpenClaw / 自定义应用)
        │
        ▼
  ┌─────────────┐
  │  走蛙 API 网关  │  ← 统一入口，OpenAI 兼容接口
  │  (zouwa.top)   │
  └────────┬────────┘
           │
     ┌─────┼─────┐
     ▼     ▼     ▼
   GPT   Claude  DeepSeek  ...  ← 上游 AI 模型提供商

下一步

快速开始
注册账号、创建密钥、发起第一次 API 调用
CC Switch 配置
将走蛙接入 CC Switch 工具
API 参考
查看 API 接口文档和调用示例

快速开始

本指南将帮助你在 5 分钟内完成走蛙的注册、密钥创建和第一次 API 调用。

前提条件

注意

走蛙平台目前采用邀请制注册，需要管理员邀请或提供邀请码才能注册账号。请联系 SCS Agent 协作创新会管理员获取邀请。

第一步：注册 / 登录

访问走蛙平台

打开 https://zouwa.top，点击 Sign In 进入登录页面。

走蛙登录页面
走蛙登录页面
登录账号

输入管理员分配的邮箱和密码，勾选服务条款，点击 Sign In 登录。

提示

首次登录后建议前往 Profile 页面修改密码。

第二步：创建 API 密钥

进入 API Keys 页面

登录后，在左侧导航栏点击 API Keys。

API Keys 管理页面
API Keys 管理页面 — 显示所有已创建的密钥
创建新密钥

点击 Create API Key 按钮，填写密钥名称，选择分组。

创建 API Key 对话框
创建 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 
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": "你好，请介绍一下自己"}
    ]
  }'
Python 
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 管理页

在左侧导航栏中点击 API Keys，进入密钥管理页面。

API Keys 管理页面
API Keys 管理页面
点击创建按钮

点击页面右上角的 Create API Key（创建密钥）按钮。

创建 API Key 对话框
创建 API Key 对话框
填写密钥信息

在弹出的创建对话框中：

  • 名称：为密钥起一个易识别的名称（如 "codex"、"hermes"、"image-gen"）
  • 分组：选择密钥所属的分组/通道，不同分组对应不同模型和费率
  • 额度（可选）：设置密钥的使用额度上限
保存密钥

创建成功后，系统会显示完整的 API Key。密钥仅显示一次，请立即复制保存。

密钥管理

在 API Keys 页面，你可以：

安全提示

请勿将 API Key 泄露给他人或提交到公开代码仓库。如果密钥泄露，请立即在控制台禁用并创建新密钥。

CC Switch 配置

CC Switch（CCS）是一个 AI 模型切换工具，通过配置走蛙 API，可以在 CCS 中便捷地切换和调用不同 AI 模型。

配置步骤

打开 CC Switch

启动 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 接入信息：

方法一：环境变量

bash 
export OPENAI_API_KEY="sk-你的走蛙API密钥"
export OPENAI_BASE_URL="https://zouwa.top/v1"

方法二：配置文件

编辑 Codex 的配置文件（通常在 ~/.codex/config.json）：

json 
{
  "api_key": "sk-你的走蛙API密钥",
  "base_url": "https://zouwa.top/v1",
  "model": "gpt-5.4"
}

推荐分组

使用 Codex 时，推荐选择以下分组创建密钥：

Hermes 配置

将走蛙 API 接入 Hermes，实现 AI 能力集成。

配置步骤

创建 Hermes 专用密钥

在走蛙控制台创建一个新的 API Key，名称建议设为 "Hermes"，分组选择 Agent 国产模型 DS。

配置 Hermes

在 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 辅助能力。

配置步骤

创建 OpenClaw 专用密钥

在走蛙控制台创建新的 API Key，根据使用需求选择合适的分组。

配置 OpenClaw

在 OpenClaw 的设置中，配置 API 连接信息：

配置 
API Base URL: https://zouwa.top/v1
API Key: sk-你的OpenClaw专用密钥
测试验证

保存配置后，发送测试请求验证连接是否正常。

控制台 Dashboard

走蛙控制台提供了全面的账户管理和用量监控功能。

Dashboard 概览

登录后进入 Dashboard 页面，你可以查看：

走蛙控制台 Dashboard
Dashboard 概览 — 余额、API Keys、请求数、消费、Token 用量
账户余额
当前可用余额和冻结余额
API Keys
已创建的密钥数量和活跃状态
今日请求
当日请求次数和累计请求总量
今日消费
当日消费金额和累计消费总额
Token 用量
当日和累计的 Token 输入/输出量
性能指标
RPM、TPM、平均响应时间

模型分布

Dashboard 还提供了模型使用分布图，展示各模型的请求次数、Token 用量和费用占比，帮助你了解消费结构。

模型分布与用量趋势
模型分布与 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 应用

分组选择建议

费率说明

费率倍率表示相对于标准价格的折扣。例如 0.5x 表示按标准价格的 50% 计费。

用量统计

走蛙提供详细的用量统计功能，帮助你追踪每一笔 API 调用的消费。

Usage 页面

在左侧导航栏点击 Usage，进入用量统计页面，可以查看：

用量统计页面
Usage 用量统计 — 请求数、Token 用量、费用分析

统计指标说明

指标 说明
RequestsAPI 请求次数
Input Tokens输入 Token 数量（发送给模型的文本）
Output Tokens输出 Token 数量（模型生成的文本）
Cache Tokens缓存 Token 数量（利用缓存减少费用）
Cost标准费用（按标准价格计算）
Actual Cost实际费用（按分组费率倍率计算后的费用）
RPMRequests Per Minute，每分钟请求数
TPMTokens Per Minute，每分钟 Token 数

管理员指南

本指南面向 SCS Agent 协作创新会 · 词元工厂的管理员，介绍如何管理走蛙平台的用户和设置。

管理员功能概览

走蛙平台的管理员拥有以下管理权限：

用户管理

添加用户

走蛙平台当前采用邀请制注册（registration_enabled: false），管理员可以通过以下方式添加用户：

生成邀请码

管理员在后台生成邀请码（invitation_code_enabled: true），将邀请码分享给新用户。

用户注册

新用户访问 https://zouwa.top/login，点击 Sign up 注册，填写邮箱、密码和邀请码。

设置用户权限

用户注册后，管理员可以在后台为用户分配分组权限（allowed_groups），控制用户可使用的通道。

用户角色

角色说明
admin管理员，拥有全部管理权限
user普通用户，可使用 API 和管理自己的密钥

分组管理

管理员可以创建和管理分组，每个分组可以配置：

充值管理

管理员可以：

用户 Profile 页面

用户可以在 Profile 页面管理个人信息、头像和登录方式：

Profile 设置页面
Profile 设置页面 — 账户信息、头像、登录方式管理

注意

管理员操作涉及用户资金和权限，请谨慎操作。建议定期审计用户用量和费用。

API 参考

走蛙提供 OpenAI 兼容的 API 接口，支持 Chat Completions 和 Messages 两种端点。

基础信息

配置项值
Base URLhttps://zouwa.top/v1
认证方式Authorization: Bearer sk-xxx
协议OpenAI 兼容 / Anthropic Messages
内容类型application/json

Chat Completions

OpenAI 兼容的聊天补全接口。

请求

HTTP 
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
}

请求参数

参数类型必填说明
modelstring是模型 ID，如 gpt-5.4、deepseek-chat 等
messagesarray是对话消息数组，包含 role 和 content
temperaturenumber否采样温度，0-2，默认 1
max_tokensinteger否最大生成 Token 数
streamboolean否是否使用流式输出，默认 false
top_pnumber否核采样参数，0-1

响应

JSON 
{
  "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 调用。

HTTP 
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

Python 
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

Python 
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

JavaScript 
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);

错误码

状态码错误码说明
401API_KEY_REQUIRED缺少 API Key
401INVALID_API_KEYAPI Key 无效或已禁用
403FORBIDDEN无权限访问该分组/模型
429RATE_LIMITED请求频率超限
429QUOTA_EXCEEDED额度已用完
500UPSTREAM_ERROR上游 AI 服务错误
503SERVICE_UNAVAILABLE服务暂时不可用

可用模型列表

通过 API 获取当前可用的模型列表：

cURL 
curl 'https://zouwa.top/v1/models' \
  -H 'Authorization: Bearer sk-your-api-key'