接入地址与认证

接入地址

不同接口格式填的地址不一样，主要区别在于末尾要不要带 /v1：

接口格式	地址	适用于
OpenAI 兼容	https://api.rabah.ai/v1	大多数应用和 SDK、Codex CLI、OpenCode
Anthropic	https://api.rabah.ai	Claude Code 和其他 Claude 类客户端
Gemini 原生	https://api.rabah.ai	Gemini CLI、Google 官方 SDK

Anthropic 地址不要带 /v1

Claude 类客户端会自己在地址后面加上 /v1/messages。如果你填成 https://api.rabah.ai/v1，实际请求就会变成 /v1/v1/messages，导致报错。

应用里的设置项名字各不相同，常见的有 Base URL、API 地址、API Endpoint、接口地址，填的都是上面这个地址。

https://hub.rabah.ai 也能调用 API，但推荐使用 api.rabah.ai：前者是网页控制台，后者专门用于 API 调用。

传递密钥

把密钥放在请求头里，下面两种写法任选一种：

Authorization: Bearer 你的密钥

x-api-key: 你的密钥

大多数 OpenAI 兼容的应用使用第一种；Claude 类客户端通常使用第二种。Gemini 原生接口也可以用 x-goog-api-key 请求头。

不要把密钥放在网址里

?key=... 或 ?api_key=... 这种写法会被拒绝，并返回 400 错误。网址经常会被记录到日志、浏览器历史和代理服务器里，放在网址里容易泄露密钥。

接口路径

在 OpenAI 兼容地址 https://api.rabah.ai/v1 后面加上下面的路径：

路径	用途
POST /chat/completions	对话，最通用的接口
POST /responses	OpenAI Responses 接口，Codex 使用
POST /messages	Anthropic Messages 接口，Claude 类客户端使用
GET /models	列出这个密钥可用的模型
POST /embeddings	文本向量
POST /images/generations	生成图片
POST /images/edits	编辑图片

一般用不着手动拼路径：在应用里填好接入地址，应用会自己加上路径。

指定模型和线路

请求里的 model 填 模型广场 中的模型名即可。

同一个模型可能有多条线路。一个密钥可以使用所有线路：

• 只写模型名，例如 claude-sonnet-4-6：使用这个模型的默认线路。
• 写成 模型名:线路代号，例如 claude-sonnet-4-6:pro：使用指定的线路。

线路代号可以在模型广场里查看。也可以调用 GET /v1/models：有多条线路的模型，会额外列出带线路代号的写法。默认线路怎么选、线路不可用时会怎样，见 线路。

限制密钥的使用范围

创建或编辑密钥时，可以给不同用途分别建密钥，并设置：

• 线路与模型：只允许使用勾选的线路和模型。
• 额度：这个密钥最多能花多少钱。
• 速率限制：5 小时、1 天、7 天内最多花多少钱。
• 有效期：到期后密钥自动停用。
• IP 限制：只允许或禁止特定 IP 使用这个密钥。

比如给一个共享的自动化脚本单独建一个密钥并设置额度，就算密钥泄露，损失也有上限。