在线充值
选择金额和支付方式,支付完成后余额会进入钱包。之后按实际调用量扣费。
适合:模型较多、用量不固定不需要会编程。跟着页面依次完成注册、充值、创建密钥和客户端配置,通常几分钟就能开始使用。
本文中的控制台地址是 https://zzzxin.xin。API 密钥通常以
sk- 开头,请勿截图、转发或公开给其他人。
创建账号
打开 zzzxin.xin,点击注册。填写用户名和密码后创建账号,已有账号直接点击“登录”。
获得可用额度
登录后打开左侧“钱包”。根据你拿到的付款方式,只选择下面其中一种即可。
选择金额和支付方式,支付完成后余额会进入钱包。之后按实际调用量扣费。
适合:模型较多、用量不固定在“有兑换码吗?”输入卡密,点击“兑换额度”,看到余额增加即完成。
适合:从客服或渠道购买了卡密选择日卡、周卡或月卡。订阅后会获得指定分组、模型和请求频率权限。
适合:长期固定使用某个模型购买订阅后先记住套餐写明的分组名称和模型名称。创建 API 密钥时必须选择相同分组,客户端中也必须填写对应模型。
最重要的一步
在左侧点击“API 密钥”,再点击右上角“创建 API 密钥”。名称只是备注,填写“我的电脑”“Cherry Studio”等方便识别的名字即可。
deepseek-v4-flash。default;如果客服指定了分组,以客服说明为准。密钥相当于账号密码。只填写到你信任的客户端,不要发到群聊、截图或提交到公开代码仓库。怀疑泄露时,请立即删除旧密钥并重新创建。
接口地址规则
客户端对 Base URL 的处理方式不同。最简单的记法是:OpenAI 兼容客户端和 Codex 加 /v1,Claude 原生客户端不加。
https://zzzxin.xin
https://zzzxin.xin/v1
https://zzzxin.xin/v1
Claude 客户端会自己拼接 /v1/messages。如果手动再加,容易变成错误的重复路径。
Codex 使用 OpenAI Responses 接口,会在 /v1 后继续访问 /responses。
看到 OpenAI Compatible、OpenAI 兼容或 Custom OpenAI,一般填写带 /v1 的地址。
不要出现 /v1/v1 或 /v1/v1/messages。如果客户端提示 404,先检查接口地址有没有重复路径。
推荐方式
如果你使用 Claude 或 Codex,推荐用 CC Switch。它会自动带入接口地址和密钥,避免手动填写错 /v1。
确保电脑已经安装 CC Switch,并允许浏览器唤起该应用。
找到刚创建的密钥,点击最右侧“更多”,选择“CC Switch”。
应用选择 Claude 或 Codex;名称可保持默认;主模型选择当前分组可用的模型。
浏览器出现外部应用提示时选择允许,在 CC Switch 中确认导入即可。
代码智能体
Codex 的自定义提供商必须写在用户配置文件 ~/.codex/config.toml 中。不要写到项目里的 .codex/config.toml,项目配置不能覆盖提供商和认证信息。
macOS / Linux:~/.codex/config.toml;Windows:%USERPROFILE%\.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"
密钥不要直接写进配置文件。执行与自己系统对应的命令,关闭终端后需要重新设置。
export ZZZXIN_API_KEY="sk-你的API密钥"
codex
$env:ZZZXIN_API_KEY="sk-你的API密钥"
codex
如果 Codex 已经打开,请完全退出后重新启动。仍提示 401 时检查环境变量中的密钥;提示 404 时检查 base_url 是否正好是 https://zzzxin.xin/v1。
配置依据:Codex 官方自定义模型提供商文档。
本地智能体
OpenClaw 支持自定义 OpenAI 兼容提供商。下面命令会添加名为 zzzxin 的提供商,再把它设为默认模型。先把两处“你的模型名称”和一处“你的API密钥”替换掉。
baseUrl固定填 https://zzzxin.xin/v1apiKey填写 API 密钥页面创建的 sk-...api固定填 openai-completionsid / name填写当前分组允许使用的准确模型名称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
PowerShell、macOS 和 Linux 终端可直接使用上面的单引号写法;Windows CMD 不适用,请改用 PowerShell。
config validate 显示有效后重启 Gateway。若服务未安装,可先运行 openclaw onboard 完成基础安装。
运行 openclaw agent --agent main --message "你好" --local。能返回文本即表示模型接入成功。
示例先使用 128000。只有套餐和模型明确支持更长上下文时再修改;模型名、分组和密钥必须属于同一套权限。
命令依据:OpenClaw 官方模型提供商文档。
国内消息渠道
这条流程不是把本站密钥填进腾讯元宝,而是让已经配置好本站模型的 OpenClaw 连接腾讯元宝机器人。你需要另外在腾讯侧创建机器人并取得 AppKey 和 AppSecret。
按上一节设置 zzzxin/你的模型名称,并确认本地测试能正常回复。
完成机器人资料和权限设置,在应用设置中取得 AppKey 与 AppSecret。这两个值不是本站 API 密钥。
把下面命令里的两个占位值替换成腾讯提供的凭据。冒号必须保留,前后不要加空格。
openclaw channels add --channel yuanbao --token "你的AppKey:你的AppSecret"
openclaw gateway restart
openclaw gateway status
腾讯元宝渠道要求 OpenClaw 2026.4.10 或更高版本。机器人不回复时,先运行 openclaw --version 和 openclaw logs --follow;群聊默认需要先 @ 机器人。
渠道依据:OpenClaw 腾讯元宝渠道文档。该渠道插件由腾讯元宝团队维护,不属于 OpenClaw 核心插件。
模型智能体
如果你的套餐包含 DeepSeek 模型,可以在 OpenClaw 中把它设为智能体主模型。这里仍使用本站 API 密钥和本站接口,不需要另外购买 DeepSeek 官方 API 密钥。
到本站控制台查看当前分组允许的模型,例如页面实际显示的 deepseek-...。不要根据网上文章猜模型名。
订阅用户选择套餐指定分组;余额用户通常选择 default。密钥名称可填“DeepSeek 智能体”。
使用上一节的自定义提供商命令,把两处“你的模型名称”替换成刚确认的 DeepSeek 模型名。
运行 openclaw models set zzzxin/你的模型名称,再执行本地消息测试。
DeepSeek 官方网页和手机聊天应用没有第三方 Base URL 输入项,不能直接填本站密钥。需要第三方接口时,请使用 OpenClaw、Cherry Studio、Chatbox 或其他支持 OpenAI 兼容接口的客户端。
国内常见客户端
在支持 OpenAI Compatible、OpenAI 兼容或自定义提供商的平台里,通常只需要填写下面三项。
https://zzzxin.xin/v1
sk-... 密钥
设置 → 模型服务 → 添加提供商 → OpenAI。API 地址填带 /v1 的地址,填入密钥,再手动添加准确模型名并测试。
设置 → 模型提供方 → 添加自定义提供方 → OpenAI API。依次填写 API 密钥、API Host 和模型名称。
工作区设置 → 模型供应商,安装 OpenAI-API-compatible 类型的供应商。Base URL 填带 /v1 的地址,再填写密钥和模型名。
需要管理员在模型配置或外部连接中新增 OpenAI Compatible。普通成员看不到提供商设置时,请联系部署管理员。
模型名必须与账号可用模型完全一致,包括大小写和连接符。若提示“模型不存在”,回到控制台查看当前分组允许的模型。
最后检查
在客户端新建对话,选择刚添加的模型并发送“你好”。能正常返回内容就说明配置成功。会使用命令行的用户也可以用下面的示例测试。
curl https://zzzxin.xin/v1/chat/completions \
-H "Authorization: Bearer 你的API密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "你的模型名称",
"messages": [
{"role": "user", "content": "你好"}
]
}'
密钥填写错误、已禁用或被删除。重新复制密钥。
通常是 /v1 重复或缺失,按接口地址表重新填写。
模型名与密钥分组不匹配,检查套餐、分组和模型是否一致。
钱包余额不足,或者订阅已经过期,需要充值或续订。
FAQ
不是。兑换码只用于充值余额;API 密钥需要在“API 密钥”页面单独创建。
检查 API 密钥是否选择了订阅对应分组,并确认客户端填写了套餐支持的模型名称。
Codex 和普通 OpenAI 兼容客户端加;Claude 原生客户端不加。使用 CC Switch 一键导入时无需手动判断。
不需要。同一账号的有效余额、订阅和密钥可以在其他设备使用;请注意密钥安全。
立即在 API 密钥页面删除泄露的密钥,然后创建一个新密钥并更新客户端配置。