第一个请求

这一页提供最小可用的请求模板。建议顺序很简单：先看模型列表，再发送正式请求。

推荐顺序

先用模型列表接口确认当前 Key 可见什么模型。
再复制模型名发第一条正式请求。
curl 跑通之后，再去接客户端或 SDK。

通用准备

Base URL: https://puaai.xyz
Authorization: Bearer sk-your-api-key

1. 模型列表自检

curl https://puaai.xyz/v1/models \
  -H "Authorization: Bearer sk-your-api-key"

大多数客户端和 API 调用都先看 /v1/models。特殊客户端按对应接入页单独配置即可。

2. Claude / Anthropic 兼容请求

curl https://puaai.xyz/v1/messages \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -X POST \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 256,
    "messages": [
      { "role": "user", "content": "Reply with: puaai ok" }
    ]
  }'

3. OpenAI Chat Completions 兼容请求

curl https://puaai.xyz/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -X POST \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [
      { "role": "user", "content": "Reply with: puaai ok" }
    ]
  }'

4. OpenAI Responses 兼容请求

curl https://puaai.xyz/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -X POST \
  -d '{
    "model": "gpt-5.4-mini",
    "input": "Reply with: puaai ok"
  }'

5. 成功与失败的判断

成功时你通常会看到

模型列表接口返回一个模型数组
消息接口返回正常结果或流式片段
账单 / 用量后台出现记录

失败时最先排查

Base URL 填错
Key 没绑分组
模型名不在当前分组可见范围内
入口协议和分组平台不匹配

模型列表入口和正式请求入口不是一回事

OpenAI 分组通常走 /v1/chat/completions 或 /v1/responses；Claude / Anthropic 分组通常走 /v1/messages。不要因为 /v1/models 能返回，就把正式请求入口混用。

不要一开始就在复杂客户端里盲配

像 Cline、Open WebUI、LobeChat、Claude Code、Gemini CLI 这类客户端，往往会把协议细节和请求体包装起来。先跑一遍 curl，排错成本会低很多。

6. 接入客户端前的建议

如果你接的是 Cline、Open WebUI、LobeChat、Claude Code、Gemini CLI 一类客户端，先用 curl 跑通一次，再去填客户端配置，会少掉大半排错时间。

如果你接的是具体编程工具，可以直接继续看：