常见问题
常见问题|注册、充值、API Key 与计费
了解 ZHUAN 的注册、充值、API Key、计费与接入规则。从这里找到答案,再按指南完成你的第一次调用。
ZHUAN 是什么?
ZHUAN 是一个 AI API 接入平台。个人用户可将 API 地址和 Key 配置到兼容的 AI 助手中使用,也可用于自己的应用。一个 API Key 可调用目录中可用的 Claude、GPT 等模型,支持按量计费,以及余额和调用明细查询。
如何注册,需要邮箱吗?
注册只需要用户名和两次一致的密码,无需邮箱。用户名为 5–32 位字母、数字或 _ . -;密码为 8–72 位,支持字母、数字和符号。请使用独立且不易猜测的密码。
注册后可以直接调用模型吗?
新账户初始余额为零。先在线充值,支付确认并入账后,在控制台的 API 密钥页面点击生成 API Key。没有余额时,生成入口会引导你前往充值页面。
最低充值多少,支持哪些付款方式?
首次充值最低 1 美元,首笔到账后每笔最低 10 美元,单笔最高 5000 美元。可使用银行卡或加密货币,支持预设金额和自定义金额。订单金额就是本站增加的美元余额;支付渠道的币种换算以结账页为准。
付款后余额没有立即变化怎么办?
付款返回页面不等于支付已确认。请在充值页面查看订单状态并刷新;银行卡确认和加密货币网络确认可能需要时间。若付款完成后仍未入账,请通过 Telegram 提供订单信息,避免为同一订单重复付款。
一个账户可以创建几个 API Key?
每个账户同时只有一个有效 API Key。后续充值会增加同一账户及有效密钥的可用额度,无需为每次充值创建新 Key。Key 仅用于模型调用,不能用作网站后台登录凭据。
Key 被吊销后,余额还在吗?
吊销会使旧 Key 失效,未用余额保留在账户中。没有有效 Key 时,之后的充值也记入账户余额。余额大于零时可重新申请,完成后得到全新且不同的 Key;请更新应用中的凭据。若页面显示正在核对,请等待处理完成或联系客服。
API 地址和 Model ID 怎么填?
OpenAI Python SDK 的 base_url 为 https://key.zhuan.xyz/v1;Anthropic Python SDK 的 base_url 为 https://key.zhuan.xyz/proxy。Model ID 请从价格目录复制,保留完整名称,不要填写模型显示昵称。
Token 和缓存如何计费?
价格目录以美元 / 百万 Token 展示输入、输出、缓存读取和缓存写入价格。估算时,各类计费 Token 分别乘以对应单价后相加,再除以一百万;不要把已按缓存计费的输入重复算作普通输入。不同模型的用量字段可能不同,实际费用以控制台明细为准。
价格更新会影响已有 Key 吗?
公开价格页展示新建密钥的当前价格。已有 Key 沿用创建时锁定的计费比例,但模型基础价格仍可能变化。请在控制台查看自己密钥对应的价格和消费,不要用当前公开价反推历史账单。
在哪里查看余额和调用费用?
控制台的账户概览显示可用余额和累计调用消费,使用记录显示逐次请求的模型、Token、费用和耗时,余额明细记录充值及管理员额度调整。调用费用与充值金额是不同指标;逐笔显示精度和同步时间也可能造成很小的汇总差异。
支持流式返回吗?
兼容接口支持流式响应。OpenAI SDK 使用 stream=True;Anthropic SDK 可使用 messages.stream。具体参数和事件格式取决于所选模型与接口,先用小请求验证,再接入业务。
遇到 401、402、403 或 429 怎么办?
- 401:检查是否使用本站生成的有效 Key,以及 Authorization 或 x-api-key 请求头。
- 402:检查可用余额,充值确认后再重试。
- 403:检查账户和 Key 状态;仍受限时提供请求 ID 联系客服。
- 429:降低并发和请求频率,按 Retry-After(如有)等待并使用退避重试。
充值后可以退款吗?
充值为最终交易,不支持普通退款,未用余额按政策保留。异常扣费、重复扣款等情况可申请账务核对;具体适用规则请在付款前阅读退款政策和服务条款。
如何联系 ZHUAN 客服?
通过 Telegram @zhuanxyzbot 发送问题说明、发生时间、模型名称和请求 ID。客服可以跟进账户、充值和接入问题;请勿发送密码、完整 API Key 或银行卡安全码。