Source: https://ailoot.ai/docs/zh-hant-tw/keys/
Canonical: https://ailoot.ai/docs/zh-hant-tw/keys/
Language: zh-hant-tw

[入門](https://ailoot.ai/docs/zh-hant-tw/) 

# API 金鑰與位址

[Markdown](https://ailoot.ai/docs/zh-hant-tw/keys/index.md)

在哪裡取得金鑰、各 SDK 應設定的位址，以及如何傳入金鑰。

## [](https://ailoot.ai/docs/zh-hant-tw/keys/#key)API 金鑰

金鑰可在此網站的控制台建立：[ailoot.ai](https://ailoot.ai) ，完成[註冊](https://ailoot.ai/register)後即可建立。金鑰格式為`sk-…`。可建立多把金鑰，分別用於工作電腦、伺服器與各應用程式，方便只撤銷其中一把，而不影響其他金鑰。

金鑰可設定總支出上限、有效期限、IP 允許及禁止清單，以及 5 小時、1 天與7 天時間視窗的支出上限。觸發限制時會收到易懂的錯誤：`api_key_quota_exhausted` (總上限已用盡)， `usage_limit_reached` (金鑰時間視窗的支出額度已用盡，請等待視窗更新，或提高上限)， `api_key_expired`或`permission_denied` (例如請求並非來自允許的 IP)。

請勿在程式碼、儲存庫與截圖中公開金鑰。請將它保存在環境變數或機密管理工具中。若金鑰外洩，請在控制台刪除並建立新的金鑰。

## [](https://ailoot.ai/docs/zh-hant-tw/keys/#base-url)API 位址

主要原則：OpenAI 相容用戶端的位址包含`/v1`，Anthropic與Gemini 則不包含此部分。

| 用戶端 | 基礎位址 | 請求傳送的位置 |
| --- | --- | --- |
| OpenAI SDK與相容用戶端 | `https://api.ailoot.ai/v1` | `/v1/chat/completions`，`/v1/responses`，`/v1/embeddings` |
| Anthropic SDK, Claude Code | `https://api.ailoot.ai` | `/v1/messages` |
| Google GenAI SDK, Gemini CLI | `https://api.ailoot.ai` | `/v1beta/models/{model}:generateContent` |
| 用戶端要求完整位址 | `https://api.ailoot.ai/v1/chat/completions` | 依指定內容 |

剛完成設定就收到 404？幾乎總是位址有問題，可能多加或漏加了`/v1`，使用雙斜線，或加入了`/chat/completions` ，但用戶端會自行補上此部分。

## [](https://ailoot.ai/docs/zh-hant-tw/keys/#auth)如何傳入金鑰

Ailoot 接受這三種標頭中的任一金鑰；您的 SDK 使用哪一種，就可採用哪一種：

| 標頭 | 採用此方式的用戶端 |
| --- | --- |
| `Authorization: Bearer sk-…` | OpenAI SDK與大多數用戶端 |
| `x-api-key: sk-…` | Anthropic SDK，以及使用 ANTHROPIC\_API\_KEY 的 Claude Code |
| `x-goog-api-key: sk-…` | Google GenAI SDK, Gemini CLI |

在這些路徑下：`/v1/…`不接受位址中的金鑰 (`?key=`或`?api_key=`)，請求會收到 400與此代碼：`invalid_request` ，並提示金鑰放在位址中。這能避免金鑰出現在日誌與瀏覽器歷史紀錄中。若金鑰曾放在位址中，最好建立新的金鑰。

Gemini 路徑`/v1beta/…`為了相容於 Google，接受`?key=` ，但優先順序最低，排在標頭之後。`?api_key=`在這些路徑中也會以 400 拒絕。仍建議透過此標頭傳入金鑰：`x-goog-api-key`。

## [](https://ailoot.ai/docs/zh-hant-tw/keys/#env)環境變數

建立一個環境變數，再代入不同程式的設定，使用上會更方便：

```bash
# ~/.zshrc 或 ~/.bashrc
export AILOOT_API_KEY="sk-..."

# 供讀取標準名稱的程式使用
export OPENAI_BASE_URL="https://api.ailoot.ai/v1"
export OPENAI_API_KEY="$AILOOT_API_KEY"
export ANTHROPIC_BASE_URL="https://api.ailoot.ai"
export ANTHROPIC_AUTH_TOKEN="$AILOOT_API_KEY"
```

```powershell
setx AILOOT_API_KEY "sk-..."

# 供讀取標準名稱的程式使用
setx OPENAI_BASE_URL "https://api.ailoot.ai/v1"
setx OPENAI_API_KEY "sk-..."
setx ANTHROPIC_BASE_URL "https://api.ailoot.ai"
setx ANTHROPIC_AUTH_TOKEN "sk-..."
# 重新啟動終端機以載入環境變數
```

## [](https://ailoot.ai/docs/zh-hant-tw/keys/#check)驗證金鑰

驗證金鑰最省費用的方式，是查詢模型清單，此操作免費。

```bash
curl -s https://api.ailoot.ai/v1/models \
  -H "Authorization: Bearer $AILOOT_API_KEY"
```

還有疑問嗎？請提供 Request ID與問題描述，我們會協助釐清。[聯絡支援](mailto:support@ailoot.ai)

## Ailoot · 公司及其專案組合





Ailoot以累積的營運經驗、廣大的客戶群、穩定的服務及持續的KPI管理為基礎。





公司及其專案組合：數百萬客戶，每月銷售額達數十億。





Ailoot將這些營運經驗用於API存取，讓客戶的產品、代理、應用程式及自動化流程使用AI功能。