本頁譯自英文文件。指令、識別名稱與範例保持原樣。執行環境 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 與列出的其中一個模型。若要做無頭冒煙測試，目前內建目錄支援：

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 定價。完整的 agent 任務可能把它用完。
`zai`	PAYG API 上目前的 GLM-5.3 SKU	AX Code 的選擇器從 GLM-5.3 開始。連接 `zai` 供應商，而不是 `zai-coding-plan`，並查看 Z.AI 定價以確認目前的零成本 SKU。
`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 相容」是必要條件，但對程式開發 agent 並不足夠。所選模型還需要串流文字回應，以及可靠的工具與函式呼叫。
第三方清單中的供應商名稱、模型 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`）	內建登錄表中有中繼資料與轉接器，但該供應商不屬於策展過的預設設定流程。明確設定並不保證免費模型支援 agent 工具。
僅自訂協定	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 做僅供審閱的冒煙測試。
從一個短任務與一個 agent 開始。Council、arena、長工作階段與大型儲存庫可能消耗許多請求，並很快碰到免費方案限制。
以 ax-code providers login 或環境變數儲存憑證；切勿把 API 金鑰提交到 ax-code.json。
把 429 與暫時無法使用視為正常的免費方案限制。等待供應商的重試窗口，或改選另一個目前列出的免費模型。