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

[控制台 API](https://ailoot.ai/docs/zh-hant-tw/) 

# 控制台 API

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

個人控制台的方法：登入、使用者資料、金鑰與支出紀錄。

這是 ailoot.ai 個人控制台的 API，用於登入、使用者資料、金鑰與支出紀錄。模型請求則傳送至另一個位址：`https://api.ailoot.ai` ，使用金鑰`sk-…`。可否存取各方法，取決於您的帳戶權限與已啟用的功能。

## [](https://ailoot.ai/docs/zh-hant-tw/cabinet/#adresa-i-avtorizatsiya)位址與授權

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

| 項目 | 位址 | 身分驗證 |
| --- | --- | --- |
| 控制台 API | `https://ailoot.ai/api/v1` | `Authorization: Bearer $TOKEN` —登入後取得的控制台 token |
| 模型 API | `https://api.ailoot.ai/v1` | 金鑰`sk-…`來自「API 金鑰」區；請見[API 金鑰與位址](https://ailoot.ai/docs/zh-hant-tw/keys/) |

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

讀取自己的使用者資料

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

## [](https://ailoot.ai/docs/zh-hant-tw/cabinet/#format-otveta-i-oshibki)回應格式與錯誤

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

分頁回應的結構

```json
{
  "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 驗證，也可能阻止個別請求。

## [](https://ailoot.ai/docs/zh-hant-tw/cabinet/#kak-chitat-spravochnik)如何閱讀參考文件

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

## [](https://ailoot.ai/docs/zh-hant-tw/cabinet/#balans-i-frozen-balance)餘額與frozen\_balance

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

## [](https://ailoot.ai/docs/zh-hant-tw/cabinet/#klyuchi-i-limity)金鑰與限制

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

清單與自己的金鑰

```bash
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"
```

## [](https://ailoot.ai/docs/zh-hant-tw/cabinet/#rashody-i-bezopasnost)支出與安全

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

本區共有`39`個方法。

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

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





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





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





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