> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oneinbox.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 認証

> OneInbox API キーによる API リクエストの認証方法。

すべての OneInbox API リクエストには 1 つの認証情報 — **API キー** — が必要です。

***

## API キーの取得

1. [OneInbox ダッシュボード](https://oneinbox-dashboard.vercel.app) にログイン
2. **API Keys** を開く
3. **Create API key** をクリックし、名前を付けてキーをコピー

ダッシュボードでいつでもキーの作成・失効ができます。

***

## 送信方法

すべてのリクエストにこのヘッダーを追加:

```
Authorization: Bearer <api_key>
```

例:

```bash theme={null}
curl https://api.oneinbox.ai/v1/agents \
  -H "Authorization: Bearer <api_key>"
```

***

## よくあるエラー

### API キー欠落または誤り

**症状:** 任意のエンドポイントで `401 Unauthorized`。

**対処:** ダッシュボードから完全なキーをコピーし、`Authorization: Bearer <api_key>` を使用。

### 失効または紛失したキー

ダッシュボードで新しいキーを作成し、必要に応じて古いキーを失効してください。

***

## 使用状況の確認

アカウントの使用状況（消費クレジット、通話数、請求期間）を取得します。

```bash theme={null}
curl https://api.oneinbox.ai/v1/usage \
  -H "Authorization: Bearer <api_key>"
```

***

## クイックリファレンス

| 操作                  | 場所                                                              |
| ------------------- | --------------------------------------------------------------- |
| API キーの作成・失効        | [ダッシュボード](https://oneinbox-dashboard.vercel.app) → **API Keys** |
| エージェント、モデル、通話等の呼び出し | すべてのリクエストで `Authorization: Bearer <api_key>`                    |

完全な手順 → **[クイックスタート](/jp/guides/quickstart)**