Source: https://ailoot.ai/docs/ja/cabinet/
Canonical: https://ailoot.ai/docs/ja/cabinet/
Language: ja

[ダッシュボードAPI](https://ailoot.ai/docs/ja/) 

# ダッシュボードAPI

[Markdown](https://ailoot.ai/docs/ja/cabinet/index.md)

ダッシュボードのメソッド：ログイン、プロフィール、キー、支出履歴。

ailoot.aiのダッシュボード用APIです。ログイン、プロフィール、キー、支出履歴を扱います。モデルへのリクエストは、別のアドレスに送ります：`https://api.ailoot.ai` 。使用するキーは `sk-…`です。各メソッドへのアクセスは、アカウントの権限と有効な機能によって異なります。

## [](https://ailoot.ai/docs/ja/cabinet/#adresa-i-avtorizatsiya)アドレスと認証

- ダッシュボード：https://ailoot.ai（ログインとダッシュボードのトークン）
- モデルAPI：https://api.ailoot.ai（キーsk-…）

| 項目 | アドレス | 認証 |
| --- | --- | --- |
| ダッシュボードAPI | `https://ailoot.ai/api/v1` | `Authorization: Bearer $TOKEN` は、ログイン後に取得するダッシュボードのトークンです。 |
| モデルAPI | `https://api.ailoot.ai/v1` | キー `sk-…` は「APIキー」セクションで取得します。参照：[APIキーとAPIアドレス](https://ailoot.ai/docs/ja/keys/) |

キー `sk-…` はダッシュボードのトークンの代わりにはなりません。ダッシュボードのトークンでもモデルAPIは利用できません。完全なパスは、各メソッドに記載されています。

自分のプロフィールの取得

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

## [](https://ailoot.ai/docs/ja/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
  }
}
```

ダッシュボードのトークンは、有効期限とユーザーが有効かどうかで検証されます。セッションの紐付けが有効な場合は、IPとブラウザーも確認されます。TOKEN\_EXPIRED、TOKEN\_REVOKED、USER\_INACTIVE、INVALID\_TOKEN、FORBIDDENは、セッションと権限の問題を区別するコードです。頻度制限や追加の2FA確認によって、個々のリクエストが拒否される場合があります。

## [](https://ailoot.ai/docs/ja/cabinet/#kak-chitat-spravochnik)リファレンスの読み方

- 各項目には、HTTPメソッド、完全なパス、アクセス条件、パラメータ、ボディのフィールド、レスポンスが記載されています。
- 識別子は以前取得したレスポンスから使ってください。KEY\_IDはGET /api/v1/keysから、リクエストのIDはGET /api/v1/usageから取得します。
- オブジェクトのフィールドと型は、「データスキーマ」の各ページに記載されています。
- テンプレートは、フィールド名と型を示します。PLACEHOLDERとTOKENはマーカーであり、実データではありません。
- 残高は、ダッシュボードの「料金」セクションでチャージします。詳細：[チャージ方法](https://ailoot.ai/docs/ja/billing/topup/)。

## [](https://ailoot.ai/docs/ja/cabinet/#balans-i-frozen-balance)残高とfrozen\_balance

プロフィールにはbalanceとfrozen\_balanceが含まれます。frozen\_balanceは、未完了のリクエスト用に仮確保している金額です。履歴と合わせて、両方のフィールドを確認してください。

## [](https://ailoot.ai/docs/ja/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/ja/cabinet/#rashody-i-bezopasnost)支出とセキュリティ

履歴とdashboardのactual\_costは、実際に残高から差し引かれた金額です。total\_costは標準料金に基づく金額です。日付、モデル、キー、リクエスト種別のフィルターは、各メソッドに記載されています。パスワード、TOTP、passkeyの変更には、それぞれのメソッドで説明する確認が必要です。

このセクションには `39` のメソッドがあります。

ご不明な点はありますか？Request IDと状況の説明をお送りください。調査をお手伝いします。[サポートに問い合わせる](mailto:support@ailoot.ai)

## Ailoot · 企業とそのプロジェクト群





Ailootは、蓄積した運営経験、幅広い顧客基盤、安定したサービス、継続的なKPI管理を基盤としています。





企業とそのプロジェクト群：数百万の顧客、毎月数十億規模の売上。





Ailootはこの運営経験を、お客様の製品、エージェント、アプリケーション、自動化でAI機能を利用するためのAPIアクセスに活かしています。