ZZZXIN 使用文档
BEGINNER GUIDE · 新手指南

从注册到第一次调用 API

不需要会编程。跟着页面依次完成注册、充值、创建密钥和客户端配置,通常几分钟就能开始使用。

  1. 01注册登录
  2. 02充值套餐
  3. 03创建密钥
  4. 04填写接口
  5. 05开始使用
先说明

本文中的控制台地址是 https://zzzxin.xin。API 密钥通常以 sk- 开头,请勿截图、转发或公开给其他人。

1

创建账号

注册并登录控制台

打开 zzzxin.xin,点击注册。填写用户名和密码后创建账号,已有账号直接点击“登录”。

1用户名用于登录,可填写容易记住的名称。
2密码长度按页面提示填写,并妥善保存。
3注册成功后登录,进入左侧菜单的“钱包”。
注册页面:填写用户名、密码和确认密码。
2

获得可用额度

选择充值、卡密或订阅套餐

登录后打开左侧“钱包”。根据你拿到的付款方式,只选择下面其中一种即可。

按量使用

在线充值

选择金额和支付方式,支付完成后余额会进入钱包。之后按实际调用量扣费。

适合:模型较多、用量不固定
已有卡密

兑换码充值

在“有兑换码吗?”输入卡密,点击“兑换额度”,看到余额增加即完成。

适合:从客服或渠道购买了卡密
固定套餐

订阅套餐

选择日卡、周卡或月卡。订阅后会获得指定分组、模型和请求频率权限。

适合:长期固定使用某个模型
套餐用户注意

购买订阅后先记住套餐写明的分组名称模型名称。创建 API 密钥时必须选择相同分组,客户端中也必须填写对应模型。

钱包页面同时提供在线充值、兑换码和订阅套餐。
3

最重要的一步

创建并复制 API 密钥

在左侧点击“API 密钥”,再点击右上角“创建 API 密钥”。名称只是备注,填写“我的电脑”“Cherry Studio”等方便识别的名字即可。

分组应该怎么选?

购买了订阅套餐
选择与套餐说明完全一致的分组,例如 deepseek-v4-flash
使用钱包余额按量扣费
通常选择 default;如果客服指定了分组,以客服说明为准。
“无限额度”可保持开启。高级设置不懂时不要修改。
填写名称,并选择与使用方式对应的分组。
创建完成后,密钥会出现在 API 密钥列表中。
密钥安全

密钥相当于账号密码。只填写到你信任的客户端,不要发到群聊、截图或提交到公开代码仓库。怀疑泄露时,请立即删除旧密钥并重新创建。

4

接口地址规则

什么时候加 /v1,什么时候不加

客户端对 Base URL 的处理方式不同。最简单的记法是:OpenAI 兼容客户端和 Codex 加 /v1,Claude 原生客户端不加。

应用 Base URL 是否带 /v1
Claude
https://zzzxin.xin
不加
Codex
https://zzzxin.xin/v1
需要
OpenAI 兼容
https://zzzxin.xin/v1
需要
为什么 Claude 不加?

Claude 客户端会自己拼接 /v1/messages。如果手动再加,容易变成错误的重复路径。

为什么 Codex 要加?

Codex 使用 OpenAI Responses 接口,会在 /v1 后继续访问 /responses

其他平台怎么判断?

看到 OpenAI Compatible、OpenAI 兼容或 Custom OpenAI,一般填写带 /v1 的地址。

最常见错误

不要出现 /v1/v1/v1/v1/messages。如果客户端提示 404,先检查接口地址有没有重复路径。

5

推荐方式

使用 CC Switch 一键导入

如果你使用 Claude 或 Codex,推荐用 CC Switch。它会自动带入接口地址和密钥,避免手动填写错 /v1

1

先安装并打开 CC Switch

确保电脑已经安装 CC Switch,并允许浏览器唤起该应用。

2

在 API 密钥右侧打开菜单

找到刚创建的密钥,点击最右侧“更多”,选择“CC Switch”。

3

选择应用和主模型

应用选择 Claude 或 Codex;名称可保持默认;主模型选择当前分组可用的模型。

4

点击“打开 CC Switch”

浏览器出现外部应用提示时选择允许,在 CC Switch 中确认导入即可。

密钥右侧更多菜单 → CC Switch。
选择应用和主模型后打开 CC Switch。
6

代码智能体

Codex 逐项配置

Codex 的自定义提供商必须写在用户配置文件 ~/.codex/config.toml 中。不要写到项目里的 .codex/config.toml,项目配置不能覆盖提供商和认证信息。

1

找到用户配置文件

macOS / Linux:~/.codex/config.toml;Windows:%USERPROFILE%\.codex\config.toml。文件不存在就新建。

2

粘贴下面的配置

把第一行的“你的模型名称”替换为控制台中当前分组可用的准确模型名,其余字段保持不变。

~/.codex/config.toml
model = "你的模型名称"
model_provider = "zzzxin"

[model_providers.zzzxin]
name = "ZZZXIN"
base_url = "https://zzzxin.xin/v1"
env_key = "ZZZXIN_API_KEY"
wire_api = "responses"
3

在终端临时设置 API 密钥

密钥不要直接写进配置文件。执行与自己系统对应的命令,关闭终端后需要重新设置。

macOS / Linux
export ZZZXIN_API_KEY="sk-你的API密钥"
codex
Windows PowerShell
$env:ZZZXIN_API_KEY="sk-你的API密钥"
codex
保存后要重启

如果 Codex 已经打开,请完全退出后重新启动。仍提示 401 时检查环境变量中的密钥;提示 404 时检查 base_url 是否正好是 https://zzzxin.xin/v1

配置依据:Codex 官方自定义模型提供商文档

7

本地智能体

OpenClaw 接入本站模型

OpenClaw 支持自定义 OpenAI 兼容提供商。下面命令会添加名为 zzzxin 的提供商,再把它设为默认模型。先把两处“你的模型名称”和一处“你的API密钥”替换掉。

baseUrl固定填 https://zzzxin.xin/v1
apiKey填写 API 密钥页面创建的 sk-...
api固定填 openai-completions
id / name填写当前分组允许使用的准确模型名称
macOS / Linux / PowerShell
openclaw config set models.providers.zzzxin '{"baseUrl":"https://zzzxin.xin/v1","apiKey":"sk-你的API密钥","api":"openai-completions","models":[{"id":"你的模型名称","name":"你的模型名称","contextWindow":128000,"maxTokens":32768}]}' --strict-json --merge

openclaw config set agents.defaults.model.primary '"zzzxin/你的模型名称"' --strict-json

openclaw config validate
openclaw gateway restart
1

执行配置命令

PowerShell、macOS 和 Linux 终端可直接使用上面的单引号写法;Windows CMD 不适用,请改用 PowerShell。

2

验证并重启

config validate 显示有效后重启 Gateway。若服务未安装,可先运行 openclaw onboard 完成基础安装。

3

发送本地测试

运行 openclaw agent --agent main --message "你好" --local。能返回文本即表示模型接入成功。

上下文长度不是越大越好

示例先使用 128000。只有套餐和模型明确支持更长上下文时再修改;模型名、分组和密钥必须属于同一套权限。

命令依据:OpenClaw 官方模型提供商文档

8

国内消息渠道

把 OpenClaw 接到腾讯元宝机器人

这条流程不是把本站密钥填进腾讯元宝,而是让已经配置好本站模型的 OpenClaw 连接腾讯元宝机器人。你需要另外在腾讯侧创建机器人并取得 AppKeyAppSecret

1

先完成 OpenClaw 模型配置

按上一节设置 zzzxin/你的模型名称,并确认本地测试能正常回复。

2

在腾讯元宝创建机器人

完成机器人资料和权限设置,在应用设置中取得 AppKeyAppSecret。这两个值不是本站 API 密钥。

3

添加元宝渠道

把下面命令里的两个占位值替换成腾讯提供的凭据。冒号必须保留,前后不要加空格。

腾讯元宝渠道
openclaw channels add --channel yuanbao --token "你的AppKey:你的AppSecret"
openclaw gateway restart
openclaw gateway status
版本与排错

腾讯元宝渠道要求 OpenClaw 2026.4.10 或更高版本。机器人不回复时,先运行 openclaw --versionopenclaw logs --follow;群聊默认需要先 @ 机器人。

渠道依据:OpenClaw 腾讯元宝渠道文档。该渠道插件由腾讯元宝团队维护,不属于 OpenClaw 核心插件。

9

模型智能体

创建 DeepSeek 模型智能体

如果你的套餐包含 DeepSeek 模型,可以在 OpenClaw 中把它设为智能体主模型。这里仍使用本站 API 密钥和本站接口,不需要另外购买 DeepSeek 官方 API 密钥。

1

确认准确模型名

到本站控制台查看当前分组允许的模型,例如页面实际显示的 deepseek-...。不要根据网上文章猜模型名。

2

创建对应分组的密钥

订阅用户选择套餐指定分组;余额用户通常选择 default。密钥名称可填“DeepSeek 智能体”。

3

配置 OpenClaw

使用上一节的自定义提供商命令,把两处“你的模型名称”替换成刚确认的 DeepSeek 模型名。

4

切换并测试

运行 openclaw models set zzzxin/你的模型名称,再执行本地消息测试。

DeepSeek 官方聊天应用不能这样导入

DeepSeek 官方网页和手机聊天应用没有第三方 Base URL 输入项,不能直接填本站密钥。需要第三方接口时,请使用 OpenClaw、Cherry Studio、Chatbox 或其他支持 OpenAI 兼容接口的客户端。

10

国内常见客户端

Cherry Studio、Chatbox、Dify 怎么填

在支持 OpenAI Compatible、OpenAI 兼容或自定义提供商的平台里,通常只需要填写下面三项。

OpenAI Compatible / OpenAI 兼容
https://zzzxin.xin/v1
填写刚创建的 sk-... 密钥
填写密钥分组允许使用的模型名称

Cherry Studio

设置 → 模型服务 → 添加提供商 → OpenAI。API 地址填带 /v1 的地址,填入密钥,再手动添加准确模型名并测试。

Chatbox

设置 → 模型提供方 → 添加自定义提供方 → OpenAI API。依次填写 API 密钥、API Host 和模型名称。

Dify

工作区设置 → 模型供应商,安装 OpenAI-API-compatible 类型的供应商。Base URL 填带 /v1 的地址,再填写密钥和模型名。

FastGPT / Open WebUI

需要管理员在模型配置或外部连接中新增 OpenAI Compatible。普通成员看不到提供商设置时,请联系部署管理员。

平台能否直接填本站接口正确方式
Codex / OpenClaw可以按本文专属章节配置
Cherry Studio / Chatbox可以选择 OpenAI 兼容
腾讯元宝机器人间接支持通过 OpenClaw 渠道连接
腾讯元器不能直接填没有通用第三方 Base URL 输入项
DeepSeek 官方聊天应用不能直接填改用支持兼容接口的客户端
模型名称不要猜

模型名必须与账号可用模型完全一致,包括大小写和连接符。若提示“模型不存在”,回到控制台查看当前分组允许的模型。

11

最后检查

发送一条消息测试配置

在客户端新建对话,选择刚添加的模型并发送“你好”。能正常返回内容就说明配置成功。会使用命令行的用户也可以用下面的示例测试。

curl · OpenAI Compatible
curl https://zzzxin.xin/v1/chat/completions \
  -H "Authorization: Bearer 你的API密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "你的模型名称",
    "messages": [
      {"role": "user", "content": "你好"}
    ]
  }'
401 / 认证失败

密钥填写错误、已禁用或被删除。重新复制密钥。

404 / 找不到接口

通常是 /v1 重复或缺失,按接口地址表重新填写。

模型不存在

模型名与密钥分组不匹配,检查套餐、分组和模型是否一致。

余额不足

钱包余额不足,或者订阅已经过期,需要充值或续订。

FAQ

常见问题

兑换码就是 API 密钥吗?

不是。兑换码只用于充值余额;API 密钥需要在“API 密钥”页面单独创建。

购买订阅后为什么还是不能用?

检查 API 密钥是否选择了订阅对应分组,并确认客户端填写了套餐支持的模型名称。

Base URL 到底要不要加 /v1?

Codex 和普通 OpenAI 兼容客户端加;Claude 原生客户端不加。使用 CC Switch 一键导入时无需手动判断。

换电脑需要重新买套餐吗?

不需要。同一账号的有效余额、订阅和密钥可以在其他设备使用;请注意密钥安全。

密钥泄露了怎么办?

立即在 API 密钥页面删除泄露的密钥,然后创建一个新密钥并更新客户端配置。

已复制