江湖手册
一页手册，少走弯路
备好令牌、填好地址，开始你的第一次模型调用。
案上备墨 · 即刻启程
三步，走进数字江湖
- 一
- 二
签发专属令牌
在通关令牌创建 API Key，按应用设置额度、有效期和模型权限。
- 三
节点网址
正在确认接入地址…API 地址 · OpenAI 兼容客户端
正在确认接入地址…通常填写带 /v1 的 API 地址；客户端若会自动补上 /v1，只填节点网址。
第一条请求
将完整密钥保存为 KEZHAN_API_KEY 环境变量。示例适用于支持 Chat Completions 的模型， 运行前请确认令牌可使用该模型。
正在读取模型目录，稍后会为示例填入模型名称。
正在确认当前站点的接入地址…
cURL 示例适用于 Bash 或 zsh 终端。
此处示例使用 /v1/chat/completions。Responses、图像、嵌入等模型需使用各自对应的接口，请以藏经阁标注为准。
余额与成长，各记一本账
账户额度
模型调用可使用的余额，在客栈账房查看和补充。
令牌额度
某枚密钥的使用上限，不会替账户充值，也不能突破余额限制。
Token 用量
模型输入输出的计量单位，不等于通关令牌，也不等于固定费用。
客栈成长
充值与使用会积累成长。当前等级、成长进度和适用权益在侠客行查看。
令牌随身，不轻示人
- 为每个应用创建独立令牌，避免多人共享同一凭证。
- 在服务端或环境变量保存密钥，不写进公开前端、截图、仓库或日志。
- 设置合理的额度与有效期；固定服务可以进一步限制 IP。
- 发现泄露后立即停用或删除，并更新应用凭证。
行路常见问答
提示 401 或无效令牌？
检查是否使用通关令牌的完整 sk- 密钥，而不是登录凭证；再确认令牌是否已停用、过期或被删除。
提示没有可用渠道或模型？
先从藏经阁复制完整模型名称，再检查令牌的分组与模型权限。若仍不可用，可稍后重试，并在客栈告示查看服务通知。
余额足够，为什么仍然失败？
还需检查令牌本身的额度、有效期、IP 限制和模型权限。保留返回的错误信息，并在往来账簿核对调用记录。
停止生成后还会扣费吗？
停止会结束问剑台的内容接收。已经产生的用量仍可能计费，请稍后在往来账簿查看最终费用。
客户端地址应该填什么？
OpenAI SDK 的 base_url / baseURL 使用本页提供的 /v1 地址。若客户端会自动追加 /v1，请按客户端说明填写域名，避免路径重复。
为什么成长倍率与某次费用不同？
成长权益作用于默认线路；令牌选用其他分组、动态计费和模型输出倍率会影响结算。请同时查看模型定价、所用分组和日志明细。