GPT88 / API Docs

GPT88 API Key 创建与管理

在 GPT88 控制台创建、保存、检查和轮换 API Key，并用最小请求确认密钥可用。

先分清三个入口

  • GPT88 控制台：登录、账户和余额入口是 agent.gpt88.cc。
  • API Key 管理：登录后打开 agent.gpt88.cc/keys 创建和管理 Key。
  • 程序调用：标准 API Base URL 使用 https://api.gpt88.cc；账户网页登录密码不是 API Key。

创建一把可追踪的 Key

  1. 登录 GPT88 控制台并进入「API 密钥」页面。
  2. 选择“创建密钥”，用名称标明用途，例如 web-prod、codex-dev 或 team-reporting。按环境或应用分开创建，便于单独查用量和停用。
  3. 查看当前表单提供的分组、权限或限制选项。先在模型广场确认目标模型所在分组；具体可选项和实时额度以当前账户控制台显示为准。
  4. 创建后立即复制并保存完整 Key。控制台之后通常只显示脱敏值，无法从列表恢复完整密钥。

安全保存并配置

本地验证可先通过环境变量提供凭证；生产环境使用部署平台的 Secret Manager 或等价密钥存储。

environmentbash
# macOS / Linux
export GPT88_API_KEY="在创建时保存的完整 Key"

# Windows PowerShell
$env:GPT88_API_KEY="在创建时保存的完整 Key"
  • 只在服务端读取 Key。浏览器代码、移动端包和公开前端变量都不适合保存长期凭证。
  • 不要提交到 Git。若曾误提交，删除文件并不足够，需在控制台撤销泄露的 Key，再创建新 Key。
  • 为开发、测试、生产和不同应用使用独立 Key，降低泄露或异常用量的影响范围。

发送请求并核对记录

在应用里使用 GPT88 Key 和标准 API Base URL。先用快速开始中的 cURL 或 SDK 示例发送一个最小请求，再打开控制台「使用记录」按时间和 Key 名称检查模型、分组、请求状态与扣费。

如果模型不可用，先从模型广场确认当前账户的可用分组和模型 ID；不要仅根据公开目录推断 Key 已获得权限。

搜索、停用与轮换

API 密钥列表可按名称或 Key 搜索，并使用分组、状态筛选定位记录。定期清理不再使用的测试 Key；停用或撤销前，先确认没有仍在使用它的服务。

  1. 创建一把新的 GPT88 Key，按用途命名并安全保存。
  2. 先把新 Key 配置到一个服务或环境，发送最小请求并确认使用记录正常。
  3. 逐个更新其他服务，观察它们是否已使用新 Key。
  4. 确认旧 Key 不再产生请求后，在控制台撤销旧 Key。若旧 Key 已泄露，立即撤销，不要等待常规迁移窗口。

排查成本时按 API Key、模型、分组、时间筛选使用记录；联系支持时附上时间范围、Key 名称或末尾几位、模型和 Request ID，不附完整密钥。

常见问题定位

  • 401 / invalid_api_key：检查是否误用网页登录密码、Key 是否完整、环境变量是否被当前进程读取，以及该 Key 是否已撤销。
  • 403 / 权限错误：确认模型、接口或分组在当前 Key/账户下可用，并以控制台实际选项为准。
  • 429：检查余额、限速和当前账户限制；不要靠重复创建 Key 来绕过账户级限制。
  • 终端请求成功，客户端失败：对照客户端使用的 Base URL、认证方式和模型字段，先确认客户端确实读取了这把 Key。

按端点、认证头、模型、余额和错误码逐项排查，参阅 API Key 首次请求失败排查。

从其他平台迁移到 GPT88

把原有凭证当作原平台凭证处理，不要假设它能在 GPT88 使用，也不要把旧站登录密码当作新 API Key。先在 GPT88 创建新的 Key，再按客户端协议替换 Base URL、Key 和当前可用的 GPT88 模型 ID。

迁移完成前保留旧客户端配置作为回退；验证新请求成功、用量记录出现后，再按原平台的安全流程撤销旧凭证。GPT88 的入口和账户迁移步骤见 GPT88 新站迁移教程。

acceptance-checklisttext
[ ] Key 名称能说明项目、环境或用途
[ ] 已确认该 Key 使用的分组与当前可用模型
[ ] 完整 Key 已保存到环境变量或密钥管理器
[ ] 没有把 Key 放进前端、代码仓库、截图或公开日志
[ ] 已用最小请求验证，并在使用记录中找到对应请求

相关教程