接入地址與認證

接入地址

不同接口格式填的地址不一樣，主要區別在於末尾要不要帶 /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 使用這個密鑰。

比如給一個共享的自動化腳本單獨建一個密鑰並設定額度，就算密鑰洩露，損失也有上限。