快速开始

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

前提条件

第一步：注册 / 登录

访问走蛙平台

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

走蛙登录页面

登录账号

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

提示

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

第二步：创建 API 密钥

进入 API Keys 页面

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

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

创建新密钥

点击 Create 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 -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)

API 接入信息

创建 API 密钥

API 密钥是调用走蛙平台 AI 模型的凭证。本页详细介绍如何创建和管理 API 密钥。

创建密钥步骤

登录走蛙控制台

访问 https://zouwa.top/dashboard，使用你的账号登录。

进入 API Keys 管理页

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

API Keys 管理页面

点击创建按钮

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

创建 API Key 对话框

填写密钥信息

在弹出的创建对话框中：

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

保存密钥

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

密钥管理

在 API Keys 页面，你可以：

• 查看所有已创建的密钥及其状态
• 查看每个密钥的最近使用时间和使用 IP
• 查看密钥的额度使用情况
• 禁用或删除不再需要的密钥
• 设置密钥的 IP 白名单/黑名单

CC Switch 配置

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

配置步骤

打开 CC Switch

启动 CC Switch（CCS）应用程序，点击右上角 + 按钮添加新供应商。

CC Switch 主界面 — 选择应用，点击新建

添加新供应商

在添加新供应商页面，选择 自定义配置，然后点击 添加。

添加新供应商 — 选择自定义配置

配置走蛙 API

填入走蛙 API 连接信息：

配置项	值
API Base URL	https://zouwa.top/v1
API Key	sk-你的走蛙API密钥
模型	根据分组选择对应模型 ID

选择模型

在 Model/Auth provider 中选择对应的模型提供商。

选择 Model/Auth provider

打开 Codex 测试

配置完成后，打开 Codex 选择走蛙作为 provider 进行测试：

Codex 配置 — 选择走蛙 (zouwa.top) 作为 provider

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 Base URL: https://zouwa.top/v1
API Key: sk-你的Hermes专用密钥
Model: deepseek-chat（或根据分组选择对应模型）

OpenClaw 配置

将走蛙 API 接入 OpenClaw，使用 AI 辅助能力。

配置步骤

创建 OpenClaw 专用密钥

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

配置 OpenClaw

运行 openclaw config 命令，选择 Gateway 模式：

OpenClaw 配置 — 选择 Local 模式

然后配置 API 连接信息：

配置 复制

API Base URL: https://zouwa.top/v1
API Key: sk-你的OpenClaw专用密钥

选择 API 兼容模式

选择 API 兼容模式和模型：

选择 API 兼容模式和模型

测试验证

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

控制台 Dashboard

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

Dashboard 概览

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

Dashboard 概览 — 余额、API Keys、请求数、消费、Token 用量

模型分布

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

模型分布与 Token 使用趋势

最近使用记录

在 Dashboard 底部可以查看最近的 API 调用记录，包括调用的模型、时间、Token 用量和费用。

分组与通道

走蛙通过分组（Group）机制管理不同的 AI 模型通道和费率。每个 API Key 关联一个分组，决定其可用的模型和计费标准。

可用分组

分组选择建议

• Codex 开发：选择「Codex 高速通道」（0.5x 费率，最经济）或「初创会员 VIP Codex 专属线路」
• Agent / DeepSeek：选择「Agent 国产模型 DS」（国产模型，1x 费率）
• 图片生成：选择「GPT Plus」（支持图片生成功能）
• 通用调用：根据预算和需求选择合适费率的分组

用量统计

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

Usage 页面

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

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

• 按时间范围（今天、最近 7 天、最近 30 天等）筛选用量数据
• 按模型维度查看请求次数、Token 用量和费用
• Token 使用趋势图表
• 每次 API 调用的详细记录（时间、模型、Token 数、费用）

统计指标说明

管理员指南

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

管理员功能概览

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

• 创建和管理用户账号
• 设置用户分组权限
• 管理分组和通道配置
• 查看全局用量统计
• 管理充值和订单
• 生成邀请码

用户管理

添加用户

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

用户角色

分组管理

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

• 分组名称和描述
• 关联的 AI 平台（OpenAI、Anthropic 等）
• 费率倍率（rate_multiplier）
• 日/周/月消费限额
• 是否允许图片生成
• RPM 限制
• 是否为专属分组

充值管理

管理员可以：

• 为用户账户充值
• 生成兑换码（Redeem Code）
• 查看充值记录和订单
• 设置用户余额提醒阈值

用户 Profile 页面

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

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

API 参考

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

基础信息

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
}

请求参数

响应

{
  "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);

错误码

可用模型列表

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

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