API 金鑰與位址

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

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

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

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

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

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

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

# ~/.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"

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-..."
# 重新啟動終端機以載入環境變數

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

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