ドキュメント
ダッシュボード
はじめに

APIキーとAPIアドレス

Markdown

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

完全ガイド

APIキー

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

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

APIアドレス

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

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

キーの送信方法

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。

環境変数

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

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

キーの確認

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

curl -s https://api.ailoot.ai/v1/models \
  -H "Authorization: Bearer $AILOOT_API_KEY"
ご不明な点はありますか？Request IDと状況の説明をお送りください。調査をお手伝いします。サポートに問い合わせる
ログイン新規登録ダッシュボード
料金