接入指南
快速开始|从注册充值到第一次 AI API 调用
从注册、充值到第一次模型调用:准备自己的 ZHUAN API Key,设置接口地址,再用一个小请求检查结果和费用。
1. 注册并充值
使用 5–32 位用户名和至少 8 位密码注册,无需邮箱。新账户余额为零;登录控制台后选择自助充值,可用银行卡或加密货币。首次充值最低 1 美元,首笔到账后每笔最低 10 美元,单笔最高 5000 美元。等订单显示已支付并入账,再进行下一步。
2. 生成并保存 API Key
在 API 密钥页面点击生成。每个账户只有一个有效 Key,之后充值自动增加同一账户的可用余额。把 Key 保存在服务端环境变量 ZHUAN_API_KEY 中,不要放进网页前端、截图或公开仓库。以下示例中的占位值需要替换为你自己的 Key。
# macOS / Linux
export ZHUAN_API_KEY='sk-zhuan-your-key'
# PowerShell
$env:ZHUAN_API_KEY = 'sk-zhuan-your-key'
3. 确认模型名称与价格
从价格目录复制准确的 Model ID。也可以使用下面的只读接口查询模型列表;查询列表不等于已完成模型生成请求。价格目录每天同步,某个模型支持的参数与接口请在接入时验证。
curl --fail-with-body https://key.zhuan.xyz/v1/models \
-H "Authorization: Bearer $ZHUAN_API_KEY"
4. 发送第一个小请求
以下请求使用 OpenAI 兼容的 Chat Completions 接口,示例模型为 claude-sonnet-4-6。生成请求会按实际用量计费。先验证状态码和返回文本,再尝试长上下文、流式输出或工具调用。
curl --fail-with-body https://key.zhuan.xyz/v1/chat/completions \
-H "Authorization: Bearer $ZHUAN_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"model":"claude-sonnet-4-6","max_tokens":128,"messages":[{"role":"user","content":"Hello"}]}'
5. 核对用量并处理错误
在控制台使用记录中查看本次调用的模型、Token、费用及耗时。若遇到错误,先检查 Key、模型名称和余额,再依据状态码处理;429 应降低频率并退避重试,避免不断并发重发。需要帮助时提供请求 ID,不要发送完整 Key。