常见问题 (FAQ)

整理了用户在使用智卡（Aitok）过程中最常见的问题与快速排查方案。

Q1: 账户余额充足，为什么调用大模型时提示余额不足 (402 Payment Required)？

出现此提示通常有以下两种情况：

AI 密钥设置了消费限额：在智卡中，你可以为每个独立生成的 AI 密钥设定消费上限（防超支）。如果该密钥产生的累计消费已经达到了限额，系统会拒绝该密钥的后续请求（即使你的账户主余额依然充裕）。
- 解决办法：进入控制台 “AI 密钥”（/hub/ai-key），找到对应的密钥，点击编辑并调高限额或重置周期。
极短时间内的并发超支保护：如果同时有大量高并发任务在瞬间消耗巨量 Token，系统为避免透支可能会临时触发熔断拦截。稍等数秒后重试即可。

Q2: 客户端提示 401 Unauthorized（认证失败或无效密钥）？

检查密钥格式：请确认复制的密钥是否完整（以 sk-... 开头），注意不要在首尾夹带多余的空格或换行符。
检查密钥状态：进入控制台检查该密钥是否已被临时“禁用”或“已删除”。
智卡管家本地代理模式：如果你将接口指向了 http://127.0.0.1:8309，请确认智卡管家客户端是否已登录并处于“运行中”状态。

Q3: 使用 Cursor、Windsurf 或开发工具时遇到网络连接超时？

直连远程 API 接口时，受不同地区宽带运营商网络波动影响，偶尔会出现 TLS 握手慢或连接断开。

推荐方案：下载并开启 智卡管家（Aitok Hub） 桌面端或命令行工具。
智卡管家内置了智能加速路由通道，将你的开发工具 API 地址配置为 http://127.0.0.1:8309，即可享受极低延迟且稳定的长连接体验。

Q4: 智卡接口兼容哪些格式？需要改动现有代码吗？

智卡对上游模型供应商采用完全透明的透传机制（Transparent Pass-Through），这意味着智卡支持供应商原生提供的所有格式与协议。

原生透传，无需改动：智卡不做强制的中间协议二次包装。无论供应商采用的是通用协议还是其独有的参数结构，智卡都会完整透传。
清晰展示格式：在控制台的“算力与模型”页面中，我们会明确标注并展示每个供应商支持的请求格式协议。
你只需按照对应供应商的原生格式规范直接发送请求即可，现有的代码、脚本或开源客户端均可无缝直接使用。

Q5: 为什么模型列表里有的模型无法调用？

某些极特殊的推理模型或特定预览版模型可能处于灰度阶段或上游临时维护中。
你可以前往控制台 “算力”（/hub/compute）页面查看该模型的实时可用性指示灯及状态说明。

Q6: 充值后余额有使用期限吗？如何申请发票？

永久有效：你在智卡充值的余额永久有效，不设清零期限，随用随扣。
申请发票：支持为已付款的订单开具合规发票。前往 “充值与财务 -> 发票申请”（/hub/recharge/receipt），填写你的纳税人信息，审核后电子发票将直接发送至你的邮箱。