API 参考
hxa.net 原样接受 OpenAI 和 Anthropic 的请求格式。请求和响应体以厂商自己的 API 文档为准。
接口
| 接口 | 格式 |
|---|---|
POST https://hxa.net/v1/chat/completions | OpenAI Chat Completions |
POST https://hxa.net/v1/responses | OpenAI Responses |
GET https://hxa.net/v1/models | 当前 key 可用的模型 |
POST https://hxa.net/v1/messages | Anthropic Messages |
POST https://hxa.net/v1/messages/count_tokens | Anthropic token 计数 |
流式输出与厂商一致：设置 "stream": true。
鉴权
在以下任一请求头中携带 API Key：
Authorization: Bearer YOUR_HXA_API_KEY（OpenAI SDK 及大多数工具）x-api-key: YOUR_HXA_API_KEY（Anthropic SDK）
不支持把 key 放在 URL 中（例如 ?key=）。
模型
使用价格页上的模型 ID，例如 claude-sonnet-5-5 或 gpt-6.1-sol。key 可调用哪些模型取决于其所在分组，可通过 GET /v1/models 查询。
错误码
错误沿用厂商 API 的 HTTP 状态码。常见的有：
| 状态码 | 含义 | 处理方式 |
|---|---|---|
| 400 | 请求无效 | 检查请求体和模型 ID。把 key 放在 URL 中也会返回 400。 |
| 401 | key 缺失、无效或已禁用 | 检查 key，并确认它在 API 密钥页处于启用状态。 |
| 403 | 请求不被允许 | key 已过期、来源 IP 不符合 key 的 IP 限制，或账户余额不足。续期 key、检查 IP 限制或充值。 |
| 429 | 达到限制 | key 的额度或速率限制已用完，或请求过于频繁。稍后按退避策略重试，或调高 key 的限额。 |
| 5xx | 上游或服务错误 | 按指数退避重试；持续出现请联系我们。 |