控制台 API

• 控制台：https://ailoot.ai (使用帳號登入，採用控制台 token)
• 模型 API：https://api.ailoot.ai (使用 sk-… 金鑰)

金鑰sk-…不能取代控制台 token；控制台 token 也不能存取模型 API。每個方法都列有完整路徑。

curl --fail-with-body "https://ailoot.ai/api/v1/user/profile" \
  -H "Authorization: Bearer $TOKEN"

回應包含 code、message與data。錯誤中可能還包含 reason與metadata。data 的分頁資料包含 items、total、page、page_size與pages。各方法的格式請見其說明。

{
  "code": 0,
  "message": "success",
  "data": {
    "items": [],
    "total": 0,
    "page": 1,
    "page_size": 20,
    "pages": 1
  }
}

控制台 token 會依有效期限與使用者是否啟用來驗證；若已啟用工作階段綁定，還會檢查 IP與瀏覽器。TOKEN_EXPIRED、TOKEN_REVOKED、USER_INACTIVE、INVALID_TOKEN與FORBIDDEN 代碼，用來區分工作階段與權限問題。頻率限制或額外的 2FA 驗證，也可能阻止個別請求。

• 每筆記錄都包含 HTTP 方法、完整路徑、存取條件、參數、主體欄位與回應。
• 請從先前的回應取得識別碼：KEY_ID 取自 GET /api/v1/keys，請求 ID 取自 GET /api/v1/usage。
• 物件欄位及其型別，請見「資料結構描述」頁面。
• 範本顯示欄位名稱與型別。PLACEHOLDER與TOKEN 是標記，此處沒有實際資料。
• 餘額儲值可在控制台的「方案」區進行：如何儲值。

使用者資料包含 balance與frozen_balance。frozen_balance 是為尚未完成的請求保留的金額。請搭配歷史紀錄一起檢查這兩個欄位。

GET /api/v1/keys 會傳回您的金鑰。欄位quota與quota_used —分別是金鑰的支出上限與已使用的額度； ip_whitelist，ip_blacklist，status與expires_at控制金鑰的使用； rate_limit_5h，rate_limit_1d與rate_limit_7d —各時間視窗的支出上限。

curl --fail-with-body "https://ailoot.ai/api/v1/keys" \
  -H "Authorization: Bearer $TOKEN"

# KEY_ID 是清單回應中您自己的金鑰 id
curl --fail-with-body "https://ailoot.ai/api/v1/keys/$KEY_ID" \
  -H "Authorization: Bearer $TOKEN"

歷史紀錄與儀表板會顯示 actual_cost (實際扣款)與total_cost (依標準價格計算的費用)。各方法列有日期、模型、金鑰與請求類型的篩選條件。變更密碼、TOTP與通行金鑰時，需要完成相應方法所述的確認程序。

本區共有39個方法。