このページは英語版ドキュメントの翻訳です。コマンド、識別子、例はそのままです。ランタイム 7.24.4 · SDK 2.6.7。英語版

無料枠 API クイックスタート

ステータス: 現行対象範囲: 現在の状態最終確認: 2026-08-28 所有者: ax-code runtime

AX Code はモデルの割り当てを提供しません。「無料」の実行が使うのは、外部モデルプロバイダーが提供する割り当てまたはクレジットです。その可用性、上限、データ条項、モデルカタログは、AX Code とは独立に変わり得ます。

最短の対応経路: Groq

Groq は既定の AX Code プロバイダーで、現在の AX Code モデルカタログにはツール能力のあるモデルが含まれ、Groq はそれらのモデル ID について無料プランの上限を公開しています。

Groq Console で Groq アカウントと API キーを作ります。
キーを AX Code に保存します。

ax-code providers login groq

インストール済みの AX Code リリースで使えるモデルを確認します。

ax-code models groq

ax-code を開き、/connect を実行し、Groq と一覧されたモデルの 1 つを選びます。ヘッドレスのスモークテストでは、現在の同梱カタログが次をサポートします。

ax-code run --model groq/openai/gpt-oss-120b "Inspect this repository without editing it and summarize its purpose."

その正確なモデルが ax-code models groq に表示されない場合は、表示されるモデル ID を使ってください。インストール済みカタログが、インストール済みリリースにとって正式です。

組み込みの無料枠と無料クレジットの選択肢

これらのプロバイダーは、AX Code の既定セットアップピッカーにあります。「組み込み」とは、AX Code がプロトコルアダプター、モデルメタデータ、認証情報の流れ、プロバイダーエンドポイントを供給することを意味します。すべてのモデルや要求が無料であることを意味しません。

AX Code プロバイダー	無償の経路	重要な制約
`groq`	Groq 無料プラン	レート上限はモデルとアカウントごとです。Groq の現行上限を確認してください。
`google`	無料枠の Gemini API モデル	Gemini API の価格で無料と印が付いたモデルだけが対象です。Google は、無料枠の内容が製品改善に使われることがあると述べています。
`unorouter`	`:free` で終わるモデル ID	UnoRouter はサードパーティのゲートウェイです。その無料モデルの上限は意図的に低く、可用性は変動し得ます。
`huggingface`	繰り返しの Inference Providers クレジット	無料アカウントは現在、小さな月次クレジットを受け取ります。変更されることがあります。Hugging Face の価格を参照してください。完全なエージェントタスクはそれを使い切ることがあります。
`zai`	PAYG API 上の現在の GLM-5.3 SKU	AX Code のピッカーは GLM-5.3 から始まります。`zai` プロバイダーを接続し、`zai-coding-plan` は接続しないでください。現在の無償 SKU は Z.AI の価格を確認してください。
`openrouter`	`openrouter/free`、またはモデル固有の `:free` バリアント	プロバイダープリセットは組み込みですが、AX Code のキュレーション済みスナップショットは現在、無料ルーターを一覧しません。下記のとおり明示的に追加してください。

UnoRouter では、ax-code providers login unorouter で接続し、ax-code models unorouter を実行し、ID が :free で終わるモデルを選びます。その接尾辞のない有料の対を無料だと仮定しないでください。UnoRouter 自身のカタログは、すべての無料モデルがツール呼び出しに対応するわけではないと注記しています。AX Code が同梱カタログで出すのは、ツール能力のある項目だけです。

Google または Hugging Face では、対応するプロバイダー ID で接続し、その後 ax-code models google または ax-code models huggingface を使います。モデルを選ぶ前に、プロバイダーの現行価格ページを確認してください。

OpenRouter の無料モデルルーターを追加する

OpenRouter は openrouter/free を、要求と互換性のある利用可能な無料モデルを選ぶゼロコストのルーターとして文書化しています。そのルーターは AX Code の現在のキュレーション済みスナップショットにないため、プロジェクトルートの ax-code.json（またはグローバルな AX Code 設定へマージ）に、保守的なローカルモデル項目を追加します。

{
  "$schema": "https://ax-code.app/docs-assets/schema/config.schema.json",
  "provider": {
    "openrouter": {
      "models": {
        "openrouter/free": {
          "name": "OpenRouter Free Models Router",
          "tool_call": true,
          "limit": {
            "context": 32768,
            "output": 4096,
          },
        },
      },
    },
  },
}

上の上限は、保守的な AX Code の予算値であり、OpenRouter からの権利ではありません。その後、接続してマージされたモデルカタログを検証します。

ax-code providers login openrouter
ax-code models openrouter
ax-code run --model openrouter/openrouter/free "Inspect this repository without editing it and identify its test command."

繰り返される openrouter は意図的です。最初の部分は AX Code のプロバイダー ID で、openrouter/free は OpenRouter が期待するモデル ID です。無料ルーターの可用性と選択は要求によって変わります。OpenRouter の無料ルーター文書を参照してください。

外部の無料 API カタログの使い方

awesome-free-llm-apis は現在の提供を発見するのに役立ちますが、AX Code の互換性一覧でも推奨一覧でもありません。

対応プロバイダーとモデルにあるプロバイダーは、既定の AX Code セットアッププリセットを持ちます。
models-snapshot.json に存在するだけのプロバイダーは、レジストリに裏打ちされていますが、既定のセットアップ手順向けにキュレーションされているとは限りません。
別のサービスは、互換性のある OpenAI または Anthropic のエンドポイントを出すとき、カスタムプロバイダーとゲートウェイを通じて動くことがあります。
「OpenAI 互換」はコーディングエージェントに必要ですが、十分ではありません。選ばれたモデルには、ストリーミングのテキスト応答と、信頼できるツールまたは関数呼び出しも必要です。
第三者一覧のプロバイダー名、モデル ID、無料割り当て、地域、アカウント要件は古くなり得ます。頼る前に、プロバイダー公式の価格、モデル、レート上限のページと照合してください。

このページの確認日時点で、そのカタログが名指しするサービスは AX Code へ次のように対応します。

AX Code との関係	カタログのサービス	意味
既定のセットアッププリセット	Google Gemini（`google`）、Groq（`groq`）、OpenRouter（`openrouter`）、Hugging Face（`huggingface`）、UnoRouter（`unorouter`）	通常のプロバイダーセットアップ手順に見え、上で扱っています。
レジストリに裏打ちされ、既定プリセットではない	Mistral（`mistral`）、Cohere（`cohere`）、Zhipu AI（`zhipuai`）、AnyAPI（`anyapi`）、Cerebras（`cerebras`）、NVIDIA NIM（`nvidia`）、Cloudflare Workers AI（`cloudflare-workers-ai`）	メタデータとアダプターは同梱レジストリにあります。ただしプロバイダーは、キュレーションされた既定セットアップ手順の一部ではありません。明示的な設定は、無料モデルがエージェントツールに対応することを保証しません。
カスタムプロトコルのみ	Api.Airforce、Kluster AI、LLM7.io、Pollinations AI	AX Code のプリセットはありません。現在の API がカスタムプロバイダー契約と互換のときだけ、正確なエンドポイントとモデルを設定してください。

特に、github-copilot プリセットは、一部のカタログが挙げる github-models API ではありません。一方のプロバイダー ID や認証情報の流れを、もう一方の代わりにしないでください。zai と zhipuai の一般 API は GLM-5.3 から始まります。より古い GLM 3、GLM 4、GLM-5、GLM-5.2 の SKU は除外されたままです。

安全な評価のやり方

まず公開または使い捨て可能なリポジトリで試してください。ホスト型プロバイダーまたはゲートウェイは、その API へ送られたプロンプトとコード文脈を受け取ります。
workspace-write 隔離を有効にするか、レビューだけのスモークテストには read-only を使います。
短いタスク 1 つとエージェント 1 つから始めてください。合議、arena、長いセッション、大きなリポジトリは多くの要求を消費し、無料枠の上限にすぐ達することがあります。
認証情報は ax-code providers login または環境変数で保存し、API キーを ax-code.json へ決してコミットしないでください。
429 と一時的な利用不能は、通常の無料枠の制約として扱ってください。プロバイダーの再試行窓を待つか、現在一覧されている別の無料モデルを選んでください。