JetAPI / 常见问题

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:为什么余额会变成负数?

计费是「预扣 + 结算」两段式:

  1. 请求进来时,按 max_tokens 估算预扣一部分
  2. 响应完成后,按实际用量结算,多退少补

如果预扣估少了(长上下文、大输出、多轮工具调用),结算时会补扣,此时不看余额够不够,可能扣成小幅负数。

影响有限:下一次请求的预扣检查会直接拒绝(返回「用户额度不足」), 所以最多只漏一次请求,不会持续透支。充值后恢复正常。

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 Codehttps://api.jetapi.icu多写了 /v1 → 变成 /v1/v1/messages
Codex CLI / OpenAI SDKhttps://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

超过并发或速率限制。处理方式:

Q21:503 无可用渠道

该模型当前没有可用上游。可能原因:

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:低倍率是不是质量差?

不是。低倍率主要来自两点:

代价是高峰时段可能有波动。日常问答、写代码这类可重试的任务用低倍率完全够;长任务、不能中断的场景建议换高倍率直连线路。

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 分组,各走各的。

六、相关页面