モデル一覧は見えているのに、実際のリクエストだけ失敗する——そんな経験はありませんか。

2026年6月15日、開発者のlatiblack.base.eth氏（@AHorlaplusone）がUsable-LLMを発表しました。APIキーを入力すると、そのキーで実際に使えるモデルを確認できるアプリです。統合型LLMプロバイダを使う開発者が、設定ミスや権限不足を早期に潰せる点が魅力です。

この記事でわかること

  • Usable-LLMが解決する課題と発表内容
  • 公式APIが返すモデル一覧と、キーごとの実利用可否の違い
  • 手動で確認する方法と、類似ツールとの違い

なぜ「一覧にあるのに使えない」が起きるか

LLMを呼び出すとき、多くの開発者はmodelパラメータにモデル名を指定します。ここで使える名前のリストをどこから取るかが、トラブルの起点になります。

OpenAIやAnthropicの公式APIには、キーに紐づく利用可能モデルを返すエンドポイントがあります。OpenAIはGET /v1/models、Anthropicは同じくGET /v1/modelsで、認証に使ったAPIキーがアクセスできるモデルだけを返します（OpenAI API Reference、Claude API Docs）。

一方、複数社のモデルを1つのエンドポイントにまとめた統合型LLMプロバイダ（リセラー、プロキシ、ゲートウェイなど）を使う場合、掲載モデル一覧と、手元のキーで実際に叩けるモデルが一致しないことがあります。プランや権限、在庫状況によって、ドキュメント上は存在するモデル名でも403や404が返るケースです。

latiblack.base.eth氏はUsable-LLMの紹介投稿で、「多くの統合型LLMプロバイダは、キーごとに使えるモデルを明示しておらず、正直でない場合もある」と指摘しています。開発者がモデル名をコピーして実装し、本番で初めて失敗に気づく——このギャップを埋めるのがUsable-LLMの狙いです。

Usable-LLMとは

https://x.com/AHorlaplusone/status/2066528855473410237

Usable-LLMは、APIキーを検証し、そのキーで実際に利用可能なモデルを教えてくれるアプリです。発表投稿の説明によると、次の2点に焦点を当てています。

  • キーを入力するだけで、使えるモデルを把握できる
  • 統合型プロバイダが公開しない「キー固有の利用範囲」を可視化する

発表時点では、動作デモを含む紹介動画が同じ投稿に添付されています。ダウンロード先や対応OS、料金などの詳細は、現時点ではX上の発表が主要な情報源です。新ツールのため、今後アップデートで仕様が追加される可能性があります。

手動で確認する基本手順

Usable-LLMのような専用ツールがなくても、公式エンドポイントを直接叩けばキーごとのモデル一覧は取得できます。OpenAI互換のプロバイダなら、次の形式が一般的です。

curl https://api.openai.com/v1/models \
  -H "Authorization: Bearer $OPENAI_API_KEY"

Anthropicの場合は、バージョンヘッダーとAPIキーが必要です。

curl https://api.anthropic.com/v1/models \
  -H 'anthropic-version: 2023-06-01' \
  -H "X-Api-Key: $ANTHROPIC_API_KEY"

返ってきたdata配列のidが、そのキーで指定できるモデル名です。ただし、一覧に載っていてもレート制限や一時的な障害で失敗する場合があります。Usable-LLMが「実際に使える」ことを強調しているのは、一覧取得だけでなく実リクエストに近い検証を行う設計である可能性が高いです（詳細は発表動画で確認できます）。

統合型プロバイダを使う場合は、各社が案内するベースURLに合わせてcurlの宛先を変えます。プロバイダによっては/v1/modelsを実装していないこともあり、その場合はUsable-LLMのような検証ツールや、実際のチャット補完リクエストで試す必要があります。

類似ツールとの違い

APIキーの有効性やモデル一覧を調べるツールは、Usable-LLM以前から存在します。

CheckAPI（checkapis.pages.dev）は、OpenAI・Anthropic・Geminiなど12社以上のキーをブラウザ上で検証します。キーはサーバーに送らない設計で、有効性・レイテンシ・利用可能モデルを返します。

LLM API Key Checker（GitHub: Selenium39/llm-api-key-checker-next）は、複数キーの一括検証とストリーミング進捗表示に対応したWebアプリです。POST /api/modelsでプロバイダとキーに応じたモデル一覧を取得するAPIも備えています。

これらは「キーが生きているか」「どのモデル名が返るか」が中心です。Usable-LLMは発表文のトーンから、統合型プロバイダ特有の「掲載と実態のズレ」を主眼に置いている点が異なります。複数のゲートウェイキーを運用するチームは、用途に応じて使い分ける価値があります。

運用で押さえるべきポイント

モデル互換性の確認は、LLMアプリの初期設定だけでなく、キーローテーションやプラン変更のたびに必要です。新しいモデルを本番コードに書き込む前に、対象キーで一覧またはテストリクエストを走らせる習慣をつけると、デプロイ後の障害を減らせます。

APIキーそのものは第三者のサーバーに預けない方が安全です。ブラウザ完結型の検証ツールや、自前環境で動かすオープンソースのチェッカーを選ぶときは、キーの送信先と保存ポリシーを必ず確認してください。Usable-LLMのキー処理方式は、公開情報が増え次第、利用前に公式説明を確認するのが確実です。

統合型プロバイダを使う場合は、モデル名の表記ゆれにも注意が必要です。gpt-4oとopenai/gpt-4oのように、プレフィックス付きの名前を要求するゲートウェイがあります。Usable-LLMが返す名称を、そのままbase_urlとセットでアプリに渡せるかどうかが、実運用での効き目になります。