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

[はじめに](https://ailoot.ai/docs/ja/) 

# APIキーとAPIアドレス

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

キーの取得場所、SDKごとのアドレス、キーの送信方法。

## [](https://ailoot.ai/docs/ja/keys/#key)APIキー

キーを作成するには、 [ailoot.ai](https://ailoot.ai) で [新規登録](https://ailoot.ai/register)を済ませ、ダッシュボードを開きます。キーの形式は `sk-…`です。仕事用パソコン、サーバー、各アプリケーションごとに、複数のキーを作成できます。一つを失効させる際に、他のキーへ影響を与えずに済みます。

キーには、総支出上限、有効期限、IP許可リスト、IP禁止リスト、5時間・1日・7日の支出ウィンドウ上限を設定できます。制限が適用されると、分かりやすいエラーが返ります：`api_key_quota_exhausted` （総上限に到達）、 `usage_limit_reached` （キーの支出ウィンドウ上限に到達。更新されるまで待つか、上限を引き上げてください）、 `api_key_expired` または `permission_denied` （例：許可されていないIPからのリクエスト）。

キーをコード、リポジトリ、スクリーンショットで公開しないでください。環境変数やシークレット管理ツールで保管してください。漏えいした場合は、ダッシュボードで削除し、新しいキーを作成してください。

## [](https://ailoot.ai/docs/ja/keys/#base-url)APIアドレス

基本ルール：OpenAI互換クライアントのアドレスには `/v1`を含め、AnthropicとGeminiでは含めません。

| クライアント | ベースアドレス | リクエストの送信先 |
| --- | --- | --- |
| OpenAI SDKと互換クライアント | `https://api.ailoot.ai/v1` | `/v1/chat/completions`, `/v1/responses`, `/v1/embeddings` |
| Anthropic SDK, Claude Code | `https://api.ailoot.ai` | `/v1/messages` |
| Google GenAI SDK, Gemini CLI | `https://api.ailoot.ai` | `/v1beta/models/{model}:generateContent` |
| クライアントが完全なアドレスを要求 | `https://api.ailoot.ai/v1/chat/completions` | 指定したとおり |

設定直後に404が返った場合、ほとんどはアドレスが原因です。追加しすぎ、または不足している `/v1`、二重のスラッシュ、クライアントが自動で追加する `/chat/completions` を指定していないか確認してください。

## [](https://ailoot.ai/docs/ja/keys/#auth)キーの送信方法

Ailootは、三つのヘッダーのいずれでもキーを受け付けます。SDKが送る形式をそのまま使えます：

| ヘッダー | この形式を使うクライアント |
| --- | --- |
| `Authorization: Bearer sk-…` | OpenAI SDK、多くのクライアント |
| `x-api-key: sk-…` | Anthropic SDK、ANTHROPIC\_API\_KEYを使うClaude Code |
| `x-goog-api-key: sk-…` | Google GenAI SDK, Gemini CLI |

次のパスでは、 `/v1/…` URL内のキー（`?key=` または `?api_key=`）は受け付けません。リクエストには400と次のコードが返ります：`invalid_request` 。キーをURLで渡したという説明も含まれます。キーがログやブラウザーの履歴に残らないようにするためです。すでにURLでキーを渡した場合は、新しいキーの作成を推奨します。

Geminiのパス `/v1beta/…` では、Googleとの互換性のため、 `?key=` を受け付けます。ただし、ヘッダーより後の最も低い優先順位です。`?api_key=` は、ここでも400で拒否されます。それでも、次のヘッダーでキーを渡す方が確実です：`x-goog-api-key`。

## [](https://ailoot.ai/docs/ja/keys/#env)環境変数

一つの変数を作り、複数のプログラムの設定で使うと便利です：

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

```powershell
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-..."
# 環境変数を反映するため、ターミナルを再起動する
```

## [](https://ailoot.ai/docs/ja/keys/#check)キーの確認

最も低コストのキー確認方法は、モデル一覧の取得です。無料で行えます。

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

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

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





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





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





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