拿到 Key 之后：10 分钟跑通第一个请求

接入失败的原因九成不在代码，而在这三个信息的组合不对：Base URL 少了 /v1、模型名不是对方站里的名字、或者拿 OpenAI 的写法去请求 Anthropic 兼容接口。下面按「最小可运行」给三种写法，并告诉你怎样确认自己真的打到了想用的模型。

先确认三个信息

Base URL（接口地址）

中转站控制台会给，形如 https://example.com/v1；多数 OpenAI 兼容接口要求以 /v1 结尾

API Key（密钥）

通常以 sk- 开头；本站所有检测都建议用临时 Key，不要用主力 Key

模型名

必须用对方站里列出的名字，例如 claude-sonnet-4-5、gpt-5、deepseek-chat；自动补全或猜测的名字一定失败

写法一：curl（最快确认链路通不通）

curl https://<你的站>/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxx" \
  -d '{
    "model": "<站内模型名>",
    "messages": [{"role": "user", "content": "只回复两个字：你好"}],
    "max_tokens": 32
  }'

返回 JSON 里 200 且 choices[0].message.content 有内容，说明地址、Key、模型名三者都对。HTTP 状态码的含义见 报错速查表，例如 404 多半是模型名不对，401 是 Key 不对。

写法二：Python（OpenAI SDK）

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxx",
    base_url="https://<你的站>/v1",   # 注意 /v1
)

resp = client.chat.completions.create(
    model="<站内模型名>",
    messages=[{"role": "user", "content": "只回复两个字：你好"}],
    max_tokens=32,
)

print(resp.model)          # 服务端实际使用的模型名，重点看这个
print(resp.usage)          # prompt / completion / 缓存 token 明细
print(resp.choices[0].message.content)

写法三：Anthropic 兼容接口

Claude 系列在多数中转站走 Anthropic 原生协议，路径是 /v1/messages，用 x-api-key 而不是 Authorization，并必须带 anthropic-version 头：

curl https://<你的站>/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: sk-xxxx" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 64,
    "messages": [{"role": "user", "content": "只回复两个字：你好"}]
  }'

两种协议的差别集中在三处：请求头（x-api-key vs Authorization）、路径（/v1/messages vs /v1/chat/completions）、以及返回结构（content 数组 vs choices）。把 OpenAI 的写法发到 /v1/chat/completions 去请求 Claude，如果站点做了兼容层可能通，没做就是 404。

怎样确认打到的真是你要的模型

1. 看返回体的 model 字段服务端实际用的模型名会回传，与你请求的名字不一致时，先怀疑站点做了映射。
2. 跑一条只有该模型知道的问题比如让它输出自己的知识截止日期或特定格式，用同题在官方渠道对比一次。
3. 看 usage 的缓存字段连续两轮同前缀请求，第二轮应出现缓存读取命中；完全没有缓存字段，说明这条链路不走缓存。
4. 核对扣费按站方公示单价算出应扣金额，与面板余额变化逐笔对照。

第一次就卡住的四种情况