JA ▾

curlとPythonでAI APIキーをテストする方法

3つの緑色のインジケーターライトが点灯した鍵の画像。APIキーのテスト成功を表します

何も構築することなくAI APIキーのアクセスをテストする方法:3つの呼び出し、約2分で、キーが有効で、資金があり、テキスト生成が許可されているかどうかを確認できます。

更新日:

主要ポイント

  • 最初にGET /v1/modelsを呼び出します:これはクレジットを消費せずにキーが受け入れられることを証明します。
  • モデルuncensoredに短いチャットリクエストを送信し、生成が機能することを確認します。
  • X-Balance-USDヘッダーまたはGET /v1/balanceを確認して、残高を確認します。
  • 401はキー、402は残高、429はリクエストレートを示します。

3つの呼び出しによるテスト

AI APIキーを適切にテストするには、3つの異なる事柄を確認する必要があります。サーバーがキーを受け入れること、キーにクレジットが充てられていること、そして実際の生成結果が返ってくることです。質問ごとに1回の呼び出しで診断を簡潔に保ちます。何か失敗した場合、どのレイヤーに問題があるかがわかります。

  1. モデル一覧。 キーを認証し、コストはかかりません。
  2. チャット完了。 モデルが応答し、リクエスト形式が正しいことを確認します。
  3. 残高。 テスト後の残高を確認します。

以下すべてはbase URL https://api.aiapisource.com/v1 とモデルID uncensored を使用します。キーを環境変数に設定し、シェル履歴やリポジトリに保存されないようにしてください。

export AIAPI_KEY="paste-your-key-here"

まだキーを持っていない場合は、APIキーページ で作成方法を確認できます。新規アカウントはワンクリックで$0.50の無料トライアルクレジットを取得でき、この記事のすべてのテストに十分な額です。

ステップ1:curlでモデル一覧を取得

最もコストの低いチェックは読み取り専用リクエストです。GET /v1/models はモデル一覧を返し、有効なキーを必要とするため、成功した応答は認証が成功したことを証明します。

curl -s https://api.aiapisource.com/v1/models \
  -H "Authorization: Bearer $AIAPI_KEY"

健全な応答は、uncensored を含むdata 配列を持つJSONです。HTMLページ、接続エラー、または空の応答が表示された場合、問題はキーではなくURLにあります。/v1 サフィックスが維持されていること、および変数内のキーの後に空白がないことを確認してください。

curlコマンドに-i を追加して応答ヘッダーを表示します。APIはすべての呼び出しにX-Request-Id を送信します。サポート に連絡する必要がある場合、この値を保持してください。これは正確なリクエストを識別します。

ステップ2:チャットリクエストを送信

生成を確認します。プロンプトを小さく保ち、出力を制限してテストのコストをセントのわずかな額に抑えます。

curl -s https://api.aiapisource.com/v1/chat/completions \
  -H "Authorization: Bearer $AIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Reply with the single word: ready"}],
    "max_tokens": 10
  }'

choices[0].message.content と、prompt_tokens および completion_tokens を含む usage オブジェクトを探します。入力トークン約20、出力トークン5のリクエストは、20 / 1,000,000 x $0.15 に 5 / 1,000,000 x $0.50 を加えた、約$0.0000055のコストがかかります。これらを100回実行しても、合計で1セント未満です。

同じエンドポイントはストリーミングにも使用できます:"stream": true を追加し、トークンをサーバー送信イベントとして受け取ります。基本的な呼び出しが動作したら、別途テストしてください。

ステップ3:Pythonでの同じテスト

実際のコードでOpenAI SDKを使用している場合は、SDK経由でもテストしてください。base URLが間違った引数に渡されるなど、curlでは検出できない問題をキャッチします。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AIAPI_KEY"],
    base_url="https://api.aiapisource.com/v1",
)

print([m.id for m in client.models.list().data])

r = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Reply with the single word: ready"}],
    max_tokens=10,
)
print(r.choices[0].message.content)
print(r.usage)

最初の出力にはuncensored を含むリストが表示されます。2番目の出力にはモデルの返信が表示されます。SDKセットアップの詳細については、このサイトのOpenAI API Pythonガイド を参照してください。

キーをエクスポートしたのと同じシェルからPython版を実行してください。もし AIAPI_KEY で KeyError が発生する場合、そのセッションで変数が設定されていないことを意味します。これは、ネットワークに到達する前にテストが失敗する最も一般的な理由です。

Nodeも同じ方法で動作します:OpenAIクライアントコンストラクタにbaseURL: "https://api.aiapisource.com/v1" とキーを渡します。

残高を確認

キーが有効でも、使用可能なクレジットがない場合があります。残高を確認する方法は2つあります:

curl -s https://api.aiapisource.com/v1/balance \
  -H "Authorization: Bearer $AIAPI_KEY"

# OpenAI-style alternative
curl -s https://api.aiapisource.com/v1/dashboard/billing/credit_grants \
  -H "Authorization: Bearer $AIAPI_KEY"

すべての応答にはX-Balance-USDヘッダーが付随するため、ステップ2のチャット呼び出しで-iを指定して実行した場合、残りのクレジットがすでに通知されています。Pythonでは、OpenAI SDKはclient.chat.completions.with_raw_response.create(...)を通じてこれを公開しており、response.headers["X-Balance-USD"]を読み取ることができます。

失敗または拒否されたリクエストには課金されないため、エラーが発生するテストでもクレジットは消費されません。前払いクレジットは期限切れにならないため、未使用の残高は翌週にも存在します。

エラーコードの確認

テストが失敗した場合、HTTPステータスコードは原因を迅速に特定します。

ステータス一般的な意味取るべき行動
401キーが不足、誤入力、または無効化されているAuthorization: Bearer ヘッダーを確認し、キーをコピーし直し、隠れたスペースやクォートを探す
402リクエストを支払うためのクレジットが残っていない残高を確認し、料金ページでチャージしてください
404パスまたはモデルIDが間違っている/v1/chat/completionsとモデルuncensoredを使用してください
429レートまたは同時実行数の制限、または短い過負荷待機して再試行;以下を参照

429にはエラーコードが付随します。rate_limitedは1分あたりのリクエスト数が多すぎることを意味し、concurrencyは一度に多すぎることを意味します。フルキーは1分あたり300リクエストと8つの同時リクエストを許可し、トライアルキーは1分あたり60リクエストと2つの同時リクエストを許可します。一時的な過負荷時にはAPIは429をRetry-After: 5で返し、5秒待ってからリクエストを再送信します。ストリーミングリクエストはストリームが完了するまで同時リクエスト枠を保持するため、並列テスト中にトライアルキーが制限に達する一般的な理由となります。

ステータスコード401、402、404は通常のAPI規約に従うため、表を最初の推測として扱い、正確なメッセージのためにJSONエラーボディを読んでください。

再利用可能なスモークテストスクリプト

手動テストが成功したら、キーのローテーションや環境変更後に実行できるスクリプトを保持してください。

import os, sys
import requests

BASE = "https://api.aiapisource.com/v1"
H = {"Authorization": "Bearer " + os.environ["AIAPI_KEY"]}

m = requests.get(BASE + "/models", headers=H, timeout=15)
print("models", m.status_code)

c = requests.post(
    BASE + "/chat/completions",
    headers=H,
    json={"model": "uncensored",
          "messages": [{"role": "user", "content": "ping"}],
          "max_tokens": 5},
    timeout=60,
)
print("chat", c.status_code, "balance", c.headers.get("X-Balance-USD"))
sys.exit(0 if m.ok and c.ok else 1)

終了コードにより、デプロイチェックに簡単に組み込むことができます。この最小限のパラメータを超えるパラメータについては、APIドキュメント にエンドポイントが受け付けるすべての情報がリストされています。

質問と回答

API キーのテストには料金がかかりますか?

モデルリストの呼び出しは無料です。max_tokensを低く設定した短いチャットリクエストのコストは、入力トークン100万トークンあたり$0.15、出力トークン100万トークンあたり$0.50で、$1の数百万分の1程度です。失敗したリクエストには課金されません。

カードなしでキーをテストするにはどうすればよいですか?

サインアップ後、APIキーページで$0.50のトライアルクレジットを請求してください。カードは不要で、7日間有効、1人あたり1回限りの制限です。

有効なキーなのにすぐに429が返されるのはなぜですか?

おそらく同時実行数または1分あたりの制限に達しました。トライアルキーは同時2リクエスト、1分あたり60リクエストまでを許可します。フルキーはそれぞれ8と300を許可します。エラーコードを確認し、数秒待ってから速度を落として再試行してください。

curl ではなく Postman やアプリでキーをテストできますか?

はい。OpenAI互換のクライアントはすべて動作します。ベースURLを https://api.aiapisource.com/v1 に設定し、キーをBearerトークンとして貼り付け、モデル uncensored を使用してください。

キーはフォーム1つで手に入ります

アカウントを作成し、キーをコピーし、ベースURLを変更します。これでセットアップは完了です。

API キーを取得