完整接入手册

1. 注册并登录 gpt88.cc 控制台
2. 创建一把 API Key，并立刻保存完整 Key
3. 选择接入风格：OpenAI 兼容 / Claude 兼容 / Gemini 原生图片
4. 按工具填入 Base URL、API Key、默认模型
5. 发一条最小请求，再到控制台核对用量与扣费

export GPT88_API_KEY="sk-你的-gpt88-api-key"

curl https://api.gpt88.cc/v1/chat/completions \
  -H "Authorization: Bearer $GPT88_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-haiku-4-5-20251001",
    "messages": [
      {"role": "user", "content": "用一句话介绍 gpt88.cc"}
    ]
  }'

OpenAI 兼容工具
  Base URL: https://api.gpt88.cc
  典型工具: OpenAI SDK、Codex CLI、Cursor、OpenCode、cURL

Claude / Anthropic 兼容工具
  Base URL: https://api.gpt88.cc
  典型工具: Claude Code、Anthropic SDK、OpenClaw

Google / Gemini 图片生成
  Base URL: https://img.gpt88.cc
  Endpoint: /v1beta/models/{MODEL}:generateContent

标准 API 与图片 / 视频直连分别使用以上首页地址，协议差异通过 endpoint 和请求格式处理

# ~/.codex/config.toml
model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "high"

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.gpt88.cc"
wire_api = "responses"
requires_openai_auth = true

# OpenAI 风格客户端常见环境变量
export OPENAI_API_KEY="$GPT88_API_KEY"
export OPENAI_BASE_URL="https://api.gpt88.cc"

// ~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.gpt88.cc",
    "ANTHROPIC_AUTH_TOKEN": "你的 gpt88.cc API Key",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

# Claude / Anthropic 风格客户端常见环境变量
export ANTHROPIC_AUTH_TOKEN="$GPT88_API_KEY"
export ANTHROPIC_BASE_URL="https://api.gpt88.cc"

# 如果客户端读取 ANTHROPIC_API_KEY，也可以同步设置
export ANTHROPIC_API_KEY="$GPT88_API_KEY"

排查一次请求为什么贵，按这个顺序看：

1. 看模型：是不是用了更贵的大模型
2. 看输入 Token：长对话、代码上下文、工具结果会快速堆高 prompt
3. 看输出 Token：模型输出越长，成本越高
4. 看接口类型：图片、音频、视频可能不是纯 token 计费
5. 看 API Key：是不是某个客户端或脚本在循环调用
6. 看 request_id：需要客服排查时一定要带上

401 invalid_api_key
  检查 Authorization 是否带 Bearer、Key 是否完整、是否用了 gpt88.cc 的 Key。

403 permission_denied
  当前 Key 没有该模型或接口权限，到控制台检查模型权限。

429 rate_limit_exceeded
  触发限速或额度保护，降低并发，按 Retry-After 或 retry_after_seconds 重试。

429 insufficient_quota
  余额或额度不足，到控制台充值或调整配额。

404 model_not_found
  模型名拼错或已下架，先调用 GET /v1/models 刷新本地模型列表。

413 payload_too_large
  请求体过大，压缩图片、裁剪历史消息或拆分请求。

503 service_unavailable / upstream_error
  上游拥塞或临时不可用，退避重试，必要时换模型或线路。

请求很慢
  先区分是网络慢、模型慢、上下文太长，还是流式首 token 慢。