买家使用说明

从兑换码到第一次 API 调用，只需几分钟。流量经平台网关从卖家本地网络直连官方接口，使用官方真实模型。

01快速开始

01

兑换

拿到卖家给的兑换码（AS-XXXX-…），在兑换页输入，立即获得专属 API key。

02

保存 key

key（sk-as-…）只显示一次，请立即保存。之后用量、额度、到期随时去查询页看。

03

配置测试

按下方对应客户端的示例填 Base URL 和 key，发送一条「你好」测试。就这么简单。

配置原则：改完配置要完全退出并重启客户端（不是只关设置窗口），再新建会话测试。

02接口地址与鉴权

用途填写内容说明
Claude Code / ZCodehttps://api.lumon.helpAnthropic 协议填根地址，末尾不要加 /v1
OpenAI 兼容客户端 / SDKhttps://api.lumon.help/v1SDK 会自动拼接 /chat/completions
curl 直连（OpenAI 格式）https://api.lumon.help/v1/chat/completions通用 OpenAI Chat Completions 格式
curl 直连（Anthropic 格式）https://api.lumon.help/v1/messagesClaude Code / ZCode 使用的协议格式
GLM 原生路径https://api.lumon.help/api/paas/v4/chat/completions兼容智谱官方 SDK 的原生路径

鉴权：两种写法任选其一，平台都支持 ——

Authorization: Bearer sk-as-…（OpenAI 系客户端）或 x-api-key: sk-as-…（Anthropic 系客户端）。

模型名：必须填写你的 key 实际可用的模型 ID（如 glm-4.5、glm-5.3），以兑换结果或查询页的「可用模型」为准，大小写与版本号需完全一致。

路径判断：如果请求报 404 且路径里出现 /v1/v1/…，说明客户端自动拼了路径 —— 把 Base URL 末尾的 /v1 去掉即可。

03Claude Code / ZCode 配置

通过环境变量指定接入点与 key。macOS / Linux：

export ANTHROPIC_BASE_URL="https://api.lumon.help"
export ANTHROPIC_API_KEY="sk-as-你的key"
claude

Windows PowerShell：

$env:ANTHROPIC_BASE_URL="https://api.lumon.help"
$env:ANTHROPIC_API_KEY="sk-as-你的key"
claude

说明：ANTHROPIC_AUTH_TOKEN 也可以（平台对 Bearer 与 x-api-key 一视同仁）。ZCode 配置方式相同。长期配置可写入 ~/.claude/settings.json 的 env 字段。环境变量只在当前终端生效，换个终端窗口需要重新设置。

04OpenAI 兼容客户端 / SDK

Cherry Studio、OpenCode 等任意支持自定义 Base URL 的客户端，三项内容相同：

配置项填写内容
API Keysk-as-…（兑换得到的 key，不是登录密码）
Base URLhttps://api.lumon.help/v1
Model你的 key 可用的实际模型 ID

Python（openai SDK）

from openai import OpenAI

client = OpenAI(
    base_url="https://api.lumon.help/v1",
    api_key="sk-as-你的key",
)
resp = client.chat.completions.create(
    model="glm-4.5",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

curl（OpenAI 格式）

curl https://api.lumon.help/v1/chat/completions \
  -H "Authorization: Bearer sk-as-你的key" \
  -H "Content-Type: application/json" \
  -d '{"model":"glm-4.5","messages":[{"role":"user","content":"你好"}]}'

curl（Anthropic 格式）

curl https://api.lumon.help/v1/messages \
  -H "x-api-key: sk-as-你的key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"glm-4.5","max_tokens":64,"messages":[{"role":"user","content":"你好"}]}'

查看 key 可用的模型列表

curl https://api.lumon.help/v1/models \
  -H "Authorization: Bearer sk-as-你的key"

05额度与限流

每个 key 的额度由卖家的兑换码决定，四种计费模式之一：

模式含义
窗口制每 5 小时最多 N 次 prompts，窗口滚动重置
次数制总共 N 次请求，用完即止
Token 制总共 N tokens（输入+输出），用完即止
周期制每天 / 每周 / 每月 N 次，周期自动重置

所有模式另叠加每分钟请求数（RPM）限制。到期或超额后 key 自动失效，随时在查询页输入 key 查看剩余额度、已用量与到期时间；需要续期请联系卖家。

06如何判断接入成功

下面三条同时满足，说明已经接入成功：

  • 客户端不再提示 API Key 无效或 Base URL 错误；
  • 发送一条短消息后能收到正常回复（是官方真实模型，回答质量与官方一致）；
  • 在查询页输入 key，能看到刚才的请求计入用量。

07常见问题

提示 401 / API Key 无效

先核对 key 是否复制完整（sk-as- 开头）。key 只在兑换时显示一次、平台不再展示明文；若确认丢失，联系卖家重新签发。也可能是 key 已过期或被停用 —— 去查询页看状态。

提示 404 / 路径错误

Base URL 拼错了。OpenAI 兼容客户端填 https://api.lumon.help/v1；Claude Code / ZCode 填根地址 https://api.lumon.help。路径出现 /v1/v1/… 说明拼重了，去掉 Base URL 末尾的 /v1。

提示 model not found / 无可用模型

模型名不在你的 key 允许列表里。以查询页显示的「可用模型」为准，模型 ID 的大小写、连字符、版本号必须完全一致。可用 GET /v1/models 拉取列表。

提示 429 / 限流

触发了每分钟请求数（RPM）或额度上限。稍等重试；窗口制每 5 小时自动重置，次数 / Token 制用完需联系卖家续期。具体额度在查询页可见。

请求超时或无法连接

本平台流量从卖家本机网络出口调官方 API。若卖家程序离线，请求无法完成，会收到明确的错误提示 —— 联系卖家恢复上线即可，你的 key 和额度不受影响。

key 丢失了还能找回吗

明文 key 出于安全只在兑换时显示一次，平台和卖家都无法再次查看。丢失后联系卖家重新签发或续期，旧 key 可作废。

08安全与报障

安全提醒：API key 等同于你的使用权限 —— 不要发给别人、不要贴进截图、不要提交进代码仓库或网盘。

联系卖家报障时请提供：客户端名称与版本、操作系统、请求时间、所用模型、完整的报错文字。请不要发送完整 key，只保留开头几位用于识别。