JetAPI 常见问题 FAQ
本文汇总使用 JetAPI 时最常遇到的问题,按「账户 / 计费 / 配置 / 报错」四类整理。 每条回答尽量给出可操作的具体步骤,而不是笼统说明。
一、账户与 API Key
Q1:怎么创建 API Key?
登录后进入控制台 →「API Key」页 → 新建。创建时必须选择一个分组,分组决定这个 Key 能调用哪些模型、按什么倍率计费。
控制台 → API Key → 新建 Key
├─ 名称:随便填,用于自己区分
└─ 分组:决定可调用模型与计费倍率
创建后会显示一次 Key 明文(sk- 开头),只显示这一次,请立即保存。之后只能看到掩码。
Q2:一个账号能建多少个 Key?
不限。常见做法是按分组建多个 Key,用名称区分,例如「claude-日常」「codex-重要任务」。切换时只改环境变量,不用重新建号。
Q3:Key 丢了怎么办?
无法找回明文。直接删掉旧 Key 新建一个,然后更新各处的环境变量。旧 Key 删除后立即失效。
Q4:能限制单个 Key 的额度吗?
可以。新建 Key 时可设置「额度上限」,用完后该 Key 自动停止服务,不影响账号余额和其他 Key。适合给团队成员或测试用途分配。
二、余额与计费
Q5:怎么查看余额?
控制台首页(概览)会显示当前剩余额度。也可以在「查询用量」页看到每一次调用的扣费明细。
Q6:token 是怎么算的?
每次调用返回的 usage 字段里有三项:
| 字段 | 含义 |
|---|---|
prompt_tokens | 输入消耗(你发的消息 + 系统提示) |
completion_tokens | 输出消耗(模型生成的内容) |
total_tokens | 前两项之和 |
如果命中 prompt 缓存,还会有 cache_read_input_tokens,这部分按 1/10 价计费。
Q7:扣费公式是什么?
实际扣费 = 官方单价 × 分组倍率 × 实际 token 数
举例:Claude Opus 官方 $15 / 100 万 tokens,用 ×0.2 的分组,一次调用用了 10000 tokens:
15 × 0.2 × (10000 / 1000000) = $0.03
Q8:为什么余额会变成负数?
计费是「预扣 + 结算」两段式:
- 请求进来时,按
max_tokens估算预扣一部分 - 响应完成后,按实际用量结算,多退少补
如果预扣估少了(长上下文、大输出、多轮工具调用),结算时会补扣,此时不看余额够不够,可能扣成小幅负数。
Q9:充值比例是多少?
充 1 元人民币 = 1 美元站内额度。没有倍率折算,充多少就是多少。
Q10:余额会过期吗?
不会。没有有效期限制,也不会因为长期不用而清零。
Q11:能退款吗?
未使用的额度 7 天内可联系客服申请。已消耗部分不退。建议先小额试充。
Q12:能开发票吗?
支持电子普通发票,单笔满 100 元可申请。在控制台「发票开具」页提交开票信息。
三、配置与切换
Q13:Claude Code 的 Base URL 到底带不带 /v1?
不带。填 https://api.jetapi.icu。因为 Claude Code 自己会拼 /v1/messages。
Codex CLI 相反,要填 https://api.jetapi.icu/v1。
Q14:怎么在不同线路之间切换?
因为 Key 绑定分组,切换线路 = 换 Key:
# 建多个 Key,每个绑不同分组
Key A → claude 便宜线路
Key B → claude 稳定线路
# 切换时只改环境变量
export ANTHROPIC_AUTH_TOKEN="sk-KeyA的密钥"
用 CC Switch 之类的工具可以图形化管理多套配置,点一下切换。
Q15:改了配置但没生效?
CLI 进程缓存了旧的环境变量。完全退出所有相关进程后重启:
# Windows
Get-Process | Where-Object { $_.ProcessName -match 'claude|node' } | Stop-Process
# macOS / Linux
pkill -f claude
Q16:一个 Key 能用所有模型吗?
不能。Key 属于一个分组,只能调用该分组支持的模型。想看当前能用什么:
curl https://api.jetapi.icu/v1/models \
-H "Authorization: Bearer sk-你的密钥"
四、报错排查
Q17:401 Invalid token
| 可能原因 | 检查方法 |
|---|---|
| Key 拼错或有空格 | 重新从控制台复制,注意不要带首尾空格 |
| Key 已被删除或禁用 | 控制台看 Key 状态 |
| 用了别的平台的 Key | 确认以 sk- 开头且是本站创建的 |
| 鉴权头写错 | OpenAI 协议用 Authorization: Bearer;Anthropic 协议用 x-api-key |
Q18:404 not_found
九成是 Base URL 的 /v1 写错了:
| 客户端 | 正确写法 | 常见错误 |
|---|---|---|
| Claude Code | https://api.jetapi.icu | 多写了 /v1 → 变成 /v1/v1/messages |
| Codex CLI / OpenAI SDK | https://api.jetapi.icu/v1 | 少写了 /v1 → 变成 /chat/completions |
Q19:405 Method Not Allowed
Base URL 带了多余的路径,例如 https://api.jetapi.icu/anthropic 或 https://api.jetapi.icu/deepseek。
只填域名(Claude Code)或域名 + /v1(OpenAI 客户端),不要加其他路径。
Q20:429 rate_limit_exceeded
超过并发或速率限制。处理方式:
- 降低请求频率,加退避重试(指数退避)
- 换一条线路(用别的分组的 Key)
- 如果是持续超限,联系客服提升配额
Q21:503 无可用渠道
该模型当前没有可用上游。可能原因:
- 上游临时故障
- 该模型在你这个分组下已被移除
- 模型名拼写错误(用
/v1/models确认)
Q22:403 用户额度不足
账户余额 ≤ 0。充值后立即恢复,不需要重新建 Key。
Q23:请求很慢或超时
| 可能原因 | 处理 |
|---|---|
| 选了低倍率线路,高峰期排队 | 换高倍率直连线路 |
请求的 max_tokens 太大 | 调小,或改用流式输出 |
| 上下文太长 | 开新会话,或做上下文压缩 |
| 上游本身慢 | 看服务状态页的延迟数据 |
五、模型相关
Q24:为什么模型名和官方不一样?
部分模型沿用上游的命名习惯。例如图像模型叫 gpt-image-2.6 而不是官方的 gpt-image-1;DeepSeek 是 deepseek-v4.1-flash 而不是 deepseek-v4-flash。
接入前先跑一次 GET /v1/models,拿真实模型名再配,别照抄文档。
Q25:低倍率是不是质量差?
不是。低倍率主要来自两点:
- 更高的缓存命中率(命中缓存按 1/10 价计费)
- 订阅池共享调度(多个用户的请求共用一个订阅额度)
代价是高峰时段可能有波动。日常问答、写代码这类可重试的任务用低倍率完全够;长任务、不能中断的场景建议换高倍率直连线路。
Q26:Codex 为什么每次请求都吃几千 tokens?
上游会在每次请求注入约 4400 tokens 的 system prompt(工具定义、环境信息、审批策略)。其中约 95% 命中缓存,按 1/10 价计费,等效成本约 600 tokens。
所以短请求的名义单价偏高,长对话里这个成本会被摊薄。
Q27:Claude Code 里能用 GPT 模型吗?
不能直接用。Claude Code 只发 Anthropic Messages 协议,不能调 OpenAI 协议模型。要在 Claude Code 里用 GPT,需要中间层做协议转换(如 CC Switch 的路由模式)。
更简单的做法:Claude Code 用 Claude 分组,Codex CLI 用 Codex 分组,各走各的。