接入指南

API 请求示例

三种协议的最小请求,统一使用本站网关地址。

先在本机设置环境变量 API897_KEY,将 YOUR_MODEL_ID 换成当前分组可用的完整模型 ID。下列 cURL 适用于 Bash / Zsh;执行后会产生正常调用用量。

Responses

Responses cURL
curl https://api.897654321.space/v1/responses \
  -H "Authorization: Bearer $API897_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_MODEL_ID","input":"你好"}'

Chat Completions

Chat Completions cURL
curl https://api.897654321.space/v1/chat/completions \
  -H "Authorization: Bearer $API897_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_MODEL_ID","messages":[{"role":"user","content":"你好"}]}'

Anthropic Messages / Claude 积分

Messages cURL
curl https://api.897654321.space/v1/messages \
  -H "Authorization: Bearer $API897_KEY" \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{"model":"YOUR_MODEL_ID","max_tokens":128,"messages":[{"role":"user","content":"你好"}]}'

Messages 使用 anthropic-version 请求头以及 max_tokens 输出上限。这里使用网关接受的 Bearer 令牌认证,客户端登录密码不能代替 API Key。

流式响应

在对应 JSON 请求体中加入 "stream": true,并为 cURL 加上 -N。响应按事件逐步到达,不应把整条流直接当作单个 JSON 解析。不同协议的事件格式不同。

接入应用

密钥放在服务端环境变量或安全存储中;浏览器页面向你的后端发请求,由后端调用模型。为请求设置合理的超时与输出长度,保留返回的请求编号。遇到 429 按提示等待并限制重试次数,遇到超时先查账单。

完整排错步骤见故障排查。示例只说明协议结构,不表示所有目录模型都支持这三种协议。