使用指南
接口地址与协议选择
用什么工具、调什么模型，该选哪种协议、填哪个地址、用哪个请求头放 API Key。
NoviaHub 同时提供三种「接口协议」，也就是三种请求格式：OpenAI、Anthropic（Claude）和 Google Gemini。它们都用同一个 API Key，区别只在于地址和请求格式。这一页帮你判断该用哪一种。
| 你在用什么 | 选哪种协议 | 地址（base URL）怎么填 |
|---|---|---|
| Claude Code，或其他只支持 Anthropic 接口的工具 | Anthropic Messages | https://noviahub.com |
| Codex | OpenAI Responses | https://noviahub.com/v1 |
Google 官方的 Gen AI SDK（google-genai / @google/genai） |
Gemini | https://noviahub.com |
| OpenAI 官方 SDK，以及绝大多数「支持 OpenAI 兼容接口」的应用 | OpenAI Chat Completions | https://noviahub.com/v1 |
拿不准时，优先选 OpenAI Chat Completions：截至 2026-09-29，NoviaHub 上的每一个模型都支持它。
各个工具的详细配置步骤，见集成。
看一个模型支持哪些协议
Section titled “看一个模型支持哪些协议”打开 模型&价格，点开一个模型，名称下方会列出它支持的「端点」标签：
| 标签 | 对应的协议和路径 |
|---|---|
| Chat | OpenAI Chat Completions，POST /v1/chat/completions |
| Response | OpenAI Responses，POST /v1/responses |
| Anthropic | Anthropic Messages，POST /v1/messages |
| Gemini | Gemini，POST /v1beta/models/{模型}:generateContent |
| 图片 | OpenAI Images，POST /v1/images/generations |
openai-response-compact、openai-alpha-search |
两个附加接口，见 Responses · Responses Compact 和 /v1/alpha/search |
只用模型标签里列出的协议来调用它，结果最稳定。
以 2026-09-29 线上的模型为例（模型会增减，请以模型详情页为准）：
- 全部模型都有 Chat。
- Claude 系列：Anthropic、Chat。
- Gemini 系列：Gemini、Chat。
- GPT 系列：Chat、Response、Anthropic。
glm-5.3-flash：Anthropic、Chat。- DeepSeek 系列和
kimi-k3：Chat、Response、Anthropic、Gemini 都有，另外还有openai-response-compact、openai-alpha-search。 gpt-image-2：图片、Chat。
同一个模型用不同协议调用时，NoviaHub 会在中间做格式转换。转换会带来一些差别，比如某些字段在另一种协议里没有对应项，详见协议转换兼容性。
地址到底要不要带 /v1
Section titled “地址到底要不要带 /v1”这是最容易填错的地方。原因是不同厂商的 SDK 拼接路径的方式不一样：
| 协议 | 地址填 | SDK 实际请求的地址 |
|---|---|---|
| OpenAI（Chat、Responses、Images） | https://noviahub.com/v1 |
https://noviahub.com/v1/chat/completions 等 |
| Anthropic | https://noviahub.com |
SDK 自动补上 /v1/messages |
| Gemini | https://noviahub.com |
SDK 自动补上 /v1beta/models/... |
填错时会看到下面这些现象：
- Anthropic 或 Gemini 的地址多写了
/v1：请求会变成/v1/v1/messages、/v1/v1beta/models/...这样的地址，返回 HTTP 404，内容类似Invalid URL (POST /v1/v1/messages)。 - OpenAI 的地址漏写了
/v1：请求会发到https://noviahub.com/chat/completions。这个地址不是接口，NoviaHub 会返回 HTTP 200 和一整个网页（HTML），程序通常会报「无法解析 JSON」或类似Unexpected token '<'的错误。看到这类报错，先检查地址末尾有没有/v1。 - 把完整路径填进了 base URL（例如填成
https://noviahub.com/v1/chat/completions）：SDK 还会再拼一次路径，结果同样是 404Invalid URL。
每种协议用哪个请求头放 API Key
Section titled “每种协议用哪个请求头放 API Key”| 请求头 | 在哪些接口上有效 |
|---|---|
Authorization: Bearer <API Key> |
所有接口 |
x-api-key: <API Key> |
只在 /v1/messages 和 /v1/models 上有效 |
x-goog-api-key: <API Key>，或网址后面加 ?key=<API Key> |
只在 /v1beta/models/... 和 /v1/models 上有效 |
用错请求头时，NoviaHub 读不到 Key，会返回 HTTP 401 Invalid token。例如把 x-api-key 用在 /v1/chat/completions 上。
官方 SDK 会自动使用对应的请求头，你只需要把 Key 交给 SDK。自己拼 HTTP 请求时，最稳妥的是一律用 Authorization: Bearer。