API Key 创建后第一次请求失败怎么办

按端点、认证头、模型、余额和错误码顺序排查 API Key 创建后的第一次失败。

This page is accessible in English navigation, but the full body has not been translated yet. The original Chinese content is kept below for accuracy.

问题是什么

API Key 创建成功不等于链路验证完成。第一次失败通常来自错误主机、认证头、模型名、余额或客户端解析。

最短可用配置

.envbash

export OPENAI_API_KEY=sk-替换为你创建的Key
export OPENAI_BASE_URL=https://api.gpt88.cc/v1
export OPENAI_MODEL=gpt-5.6-sol

API Key 只放在服务端环境变量或密钥管理器中，不要提交到 Git、截图、浏览器前端或公开 issue。

完整示例（curl / Python / Node.js）

request.shbash

curl https://api.gpt88.cc/v1/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"返回 OK"}],"max_tokens":32}'

request.pypython

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["OPENAI_API_KEY"],
    base_url=os.getenv("OPENAI_BASE_URL", "https://api.gpt88.cc/v1"),
)
response = client.chat.completions.create(
    model=os.getenv("OPENAI_MODEL", "gpt-5.6-sol"),
    messages=[{"role": "user", "content": "返回 OK"}],
    max_tokens=32,
)
print(response.choices[0].message.content)

request.mjsjavascript

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: process.env.OPENAI_BASE_URL ?? "https://api.gpt88.cc/v1",
});
const response = await client.chat.completions.create({
  model: process.env.OPENAI_MODEL ?? "gpt-5.6-sol",
  messages: [{ role: "user", content: "返回 OK" }],
  max_tokens: 32,
});
console.log(response.choices[0].message.content);

常见错误

401：重新复制 Key，确认 Bearer 后有空格且 Key 未撤销。
404：主机为 api.gpt88.cc，路径为 /v1/chat/completions。
400 model_not_found：从当前模型目录复制模型名和分组。
429：降低并发并退避，不要连续创建大量 Key。
超时：先用 cURL 验证 DNS、TLS 和代理。

价格和计费说明

成功请求才按当前模型、分组和用量结算。GPT88 使用人民币余额，排障时应记录一次成功请求的模型、用量和余额变化作为成本基线。