GPT88 Agent Docs

认证与计费

gpt88.cc 使用 Bearer Token 鉴权。计费、限速与 SLA 等数值由控制台与后端配置动态下发，本页面不固化具体数字。

鉴权方式

所有请求都使用 HTTP Authorization: Bearer <API_KEY>。 API Key 以 sk- 开头，长度 40+，请视为生产 secret 妥善保管。

除鉴权外，gpt88.cc 还认识下面这些可选 Header：

http
# 通用 HTTP Header
Authorization: Bearer $GPT88_API_KEY
Content-Type: application/json

# 可选：透传业务用户 ID，用于审计与风控
X-Gpt88-User: usr_abc123

# 可选：幂等键，重试同一逻辑请求时复用
Idempotency-Key: 9c4a52a4-2fdd-4b49-9e72-1a7b7b4e3a01

密钥安全

  • 仅在服务端使用：浏览器、移动端、桌面客户端都无法可靠保管 secret， 请通过自己的 server / Edge route 转发。
  • 不要写进代码仓库：使用环境变量、Vault、云厂商 secret manager。
  • 最小权限：在控制台为每个项目 / 每个环境创建独立 Key， 只授予所需模型权限。
  • 泄露立刻撤销：在控制台「API Keys」页面一键 revoke， 受影响的请求会立刻返回 401 invalid_api_key。

密钥轮换

推荐的零停机轮换流程：

bash
# 1. 在控制台创建新 Key（标注用途，例如 web-prod-2026Q2）
# 2. 滚动部署：先把新 Key 发到环境变量 GPT88_API_KEY_NEXT
# 3. 应用读取顺序：优先 NEXT，回退老 Key（双 Key 阶段）
# 4. 监控指标全部稳定后，把新 Key 改回 GPT88_API_KEY，删除老 Key

用量与计费

AI 电网与 Token 电力

很多用户从其他中转站迁移过来时，会习惯先问：倍率多少、1 块等于多少刀、额度怎么算、有没有积分体系。 gpt88.cc 的计费思路是把 Token 看成 AI 世界里的电力：官方用量是实际消耗， 分组倍率是不同上游线路对应的换算系数，最终从人民币余额中扣费。

AI Grid

我们提供的是可按官方用量核算的 AI Token 电力。

就像不同供电线路可能有不同服务成本，AI 分组也可能有不同倍率： 你可以在 API 密钥页面查看当前分组倍率，再按官方用量核算实际扣费。

  • 传统中转站积分盘 / 虚拟额度
    充值后先换成虚拟额度、刀或积分，不同模型再乘倍率，用户需要自己换算真实成本。
  • gpt88.cc官方用量 / 分组倍率必填
    充值 1 元就是账户 1 元余额，实际扣费按官方用量乘所选分组倍率计算，成本以人民币清晰呈现。

我们的计费方式

  • 充值按 1:1 折算：充值 ¥1 = 余额 1.00；页面的 $ 符号不代表美元余额。
  • 按官方用量与分组倍率扣费：实际扣费（元）= 官方用量（美元）× 所选分组倍率。
  • 分组影响单位成本：倍率越低，单位用量越便宜；不同分组对应不同上游线路与稳定性。
  • 成本透明可追踪：分组倍率在「API 密钥」页面展示，每次请求的 Token usage 和扣费以控制台记录为准。

用户常问：倍率、额度、积分

如果你之前使用的是「充值 → 换额度 / 刀 / 积分 → 再按模型倍率扣除」的中转站， 可以按下面的口径理解 gpt88.cc：

  • 你们倍率多少？倍率按分组显示在「API 密钥」页面的分组选择处，不同分组对应不同上游线路与稳定性。
  • 1 块等于多少刀？充值 ¥1 = 余额 1.00。页面以 $ 符号展示时，实际单位仍为人民币；官方用量美元仅用于扣费公式换算。
  • 额度怎么算？先读取官方 API 用量，再乘以所选分组倍率得到人民币扣费；倍率越低，单位用量越便宜。
  • 有没有积分体系？充值余额不是积分。实际扣费只需要关注官方用量、所选分组倍率和控制台记录。

限速与配额

SLA 与状态

gpt88.cc 是统一网关，整体可用性同时受网关本身和上游 provider 共同决定。 在启用智能路由的账号上，单个 provider 故障会自动切换到备用 provider， 进一步降低对应用的影响。