常见问题（FAQ）
开发者最常踩到的兼容性、安全、计费、可靠性、排障问题。如果还没回答到你的疑问，请提工单并附上 request_id。
入门
访问 Agent API Keys 控制台 → 「API Keys」页面 → 创建新的 Key。复制后注入到环境变量GPT88_API_KEY，再按照 快速开始 跑通第一次调用。
可以。在 Agent API Keys 控制台进入「配置文件导出」，选择 API Key、模型、调用线路和目标工具后即可复制配置或一键导入到 CC Switch； 详见站内文档 配置文件导出。
兼容性
兼容 OpenAI 的请求结构、错误外形和流式协议。任何官方 / 社区 OpenAI SDK 把 base_url 改为https://api.gpt88.cc 即可使用。
细节差异：/v1/models 返回多了capabilities / context_window /modalities 字段（向前兼容），错误体里多了request_id。详见 GET /v1/models。
可以。任何兼容 OpenAI 协议的上层框架都能直接用：把 provider 配置改为 OpenAI compatible，base_url 设置为https://api.gpt88.cc，api_key 用 gpt88 Key。
统一使用网站首页展示的 https://api.gpt88.cc。 其他协议差异通过请求路径、请求头和请求体字段处理，不需要切换 Base URL。
模型
无特殊场景时，建议优先从 gpt-5.6-sol 或 gpt-5.4 起步。轻量任务可选 claude-haiku-4-5-20251001 或 gpt-5.4-mini；如果你更偏好开源 / 高性价比路线，deepseek-v4-pro 等模型也仍是可选补充。中文长文本、知识整理、长周期编程、 代码分析和 Agent 工作流可以重点评测 kimi-k3；具体是否对当前账号开放， 以模型导航和控制台为准。模型导航页提供按场景挑选的视图。
调用 GET /v1/models 返回的列表就是你这把 Key 当前可用的模型。控制台「API Keys」页面也能查看每把 Key 的模型权限。
安全
不推荐。任何浏览器或客户端 App 都无法可靠保管 API Key。 请走自己的 server / Edge route 做转发，仅在服务端进程读取 Key。 Node SDK 默认 dangerouslyAllowBrowser 为 false，建议保留。
立刻在控制台「API Keys」页面 revoke 该 Key——之后任何使用都会 返回 401 invalid_api_key。再创建新 Key 走 滚动轮换，并扫一遍代码仓库 / 日志确认是否还有备份。
计费与限速
倍率是官方 API 用量换算成人民币扣费的分组系数：实际扣费（元）= 官方用量（美元）× 所选分组倍率。比如倍率 2.0 时，消耗 $1 官方额度扣除 ¥2.0； 倍率 0.5 时扣除 ¥0.5，倍率越低单位用量越便宜。
分组倍率显示在「API 密钥」页面的分组选择处，不同分组对应不同上游线路与稳定性。 充值为 1:1 折算，即充值 ¥1 = 余额 1.00；页面以 $ 符号显示时，实际单位仍为人民币。 详细说明见 认证与计费。
本文档不写具体单价。每个模型的输入 / 输出单价、计费单位、阶梯优惠都 由 gpt88.cc 控制台与后端配置动态下发，会随上游 provider 政策与商务合同变更。 请以你账号在「Billing」页面看到的实时定价为准。
同样不写死。账号级 RPM / TPM、单 Key 的 RPM / TPM / 并发、单个模型的并发与排队 上限均由控制台 Quota 配置决定。触发时返回 429 rate_limit_exceeded，请参考 重试策略。
可靠性
启用智能路由的账号，gpt88.cc 会在多个 provider 之间自动切换， 优先选择健康节点。完全无法路由时返回 503 service_unavailable， 建议客户端按指数退避重试。
正式 SLA（月可用性目标、补偿条款等）以你的商务合同与控制台公开的服务条款为准， 本文档不写具体百分比。
排障
请至少附上：
- 失败响应里的
error.request_id或 HeaderX-Request-Id； - HTTP 状态与业务 code；
- 调用的模型 ID 与请求时间（含时区）；
- 是否有定时复现规律（每小时整点 / 大流量段等）。
响应 Header X-Upstream-Latency 给出上游模型推理耗时，X-Gateway-Latency 给出 gpt88.cc 网关耗时。 如果两个都很正常但客户端测到很慢，问题大概率在客户端到网关的网络链路上。