Google: Gemma 4 31B (free)
Gemma 4 31B IT 是 Google 為文字與視覺推理進行指令微調的稠密模型。它結合 256K 上下文、可設定的思考模式、圖片理解與原生函式呼叫，以文字輸出支援程式設計、文件與代理任務。
關於模型
此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。
Gemma 4 31B IT 是 Google DeepMind 開放 Gemma 4 系列中，經指令微調的稠密版本。Google 將 31B 模型定位於模型品質與任務調適，而另一個 26B A4B 版本則採用混合專家架構，著重推論效率。本卡介紹的是這個具名的指令微調 31B 版本，而非其預訓練權重或量化衍生版本。
官方稠密架構表列出 307 億個參數、60 層、1,024-token 滑動視窗與 256K-token 上下文。此系列結合局部滑動視窗注意力與全域注意力，以全域層結尾，並為此模型使用專用的視覺編碼器。因此，此規格以文字和圖片為輸入，輸出文字。這些是模型架構資訊，並未限定應用程式的回應時間，也不代表具備其他 Gemma 4 規模版本的音訊支援。
其 256K-token 上下文可處理同時包含大量文字與視覺證據的任務。圖片與文字可以在同一份提示詞中交錯排列；製造商建議將圖片內容放在相關文字之前，以取得較佳結果。視覺任務包括物件偵測、文件頁面判讀、螢幕與介面理解、圖表、多語言 OCR、手寫文字與位置指認。輸出為文字：擷取的內容、說明、程式碼，或建議的工具動作。
可設定的思考模式讓模型能先推理再回答，也能直接作答。Gemma 4 在 user 與 assistant 角色之外，加入原生 system 角色。Google 的提示格式可在系統提示詞中使用 <|think|> 控制 token 啟用思考，並將思考通道與最終答案分開；文件所述的處理器能處理這個範本。多輪對話應在歷史紀錄中保留先前的最終答案，排除先前的思考內容；工具呼叫回合則例外，製造商表示這類回合應保留思考內容。
原生 Function Calling 支援結構化工具使用，Google 的發表說明也記載了結構化 JSON 輸出。請定義任務、可用函式與預期結果；由應用程式執行所請求的操作，再將輸出傳回供下一步使用。程式設計任務可要求產生、補全或修正程式碼，視覺助理則可使用回傳文字解釋圖表或畫面。函式呼叫指令與已實際執行的連接動作是不同的事。
可變的圖片解析度由視覺 token 預算控制。文件列出的選項為 70、140、280、560 與 1,120 tokens。較低預算適合分類或圖片說明；較高預算會保留更多 OCR、文件解析與小字所需的細節，同時增加運算量。準備圖片前，先決定需要整體場景還是精確文字。對文字擷取任務而言，一張清楚裁切的標籤圖片，可能比籠統要求檢查整頁所有細節更有用。
Google 建議此系列採用 temperature 1.0、top-p 0.95 與 top-k 64 的取樣設定。模型卡區分了超過 140 種語言的訓練範圍，以及超過 35 種語言的開箱即用支援。請在任務說明中明確指定回答語言，以及必須保留的網域名稱、欄位名稱或公式。256K 是上下文規格；引用的模型卡並未為此版本另行訂出通用的最大輸出量。
處理文件與程式碼任務時，請提供相關頁面圖片、文字需求與原始碼片段，例如：「閱讀標籤，說明這個畫面與規格有哪些差異，並針對所附程式碼提出範圍明確的修正。」分析圖表時，可要求答案區分可見數值與推論出的趨勢。Gemma 的模型卡指出，模型在模糊語言、非常複雜的任務，以及不正確或過時的事實陳述上存在限制，因此應附上結果必須依據的權威事實，而非期待訓練知識自行補足。
透過 Ailoot，請在 /v1/chat/completions 中選擇這個確切的模型 ID，並在 messages 提供任務。每則訊息都包含角色與內容；請將相關指令與來源材料放在一起。收集完整 JSON 回應，或在啟用 stream 時收齊所有 SSE 片段，並將 usage 與文字結果一併保留。
Ailoot Ultra · OpenAI Chat POST /v1/chat/completions google/gemma-4-31b-it:free
google/gemma-4-31b-it:free入門
Gemma 4 31B IT 是 Google 為文字與視覺推理進行指令微調的稠密模型。它結合 256K 上下文、可設定的思考模式、圖片理解與原生函式呼叫，以文字輸出支援程式設計、文件與代理任務。
- 接受的輸入
- 文字 · 圖片
- 結果
- 文字
Ailoot 可用 · 輸入與方法
Ailoot Ultra · OpenAI Chat POST /v1/chat/completions
- 輸入
text,image- 輸出
text- 輸出格式
- JSON or SSE
| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
|---|---|---|---|---|
欄位model | 類型string | 要求必填 | 值與限制 google/gemma-4-31b-it:free 條件: 請原樣使用這個 Ailoot 路由選擇值。 | 預設值— |
欄位messages | 類型array | 要求必填 | 值與限制 條件: | 預設值— |
欄位stream | 類型boolean | 要求選填 | 值與限制 條件: | 預設值false |
輸入素材組合
text_input · 必填： messages
image_with_text · 必填： messages with actual image content blocks
方法參數與生命週期
| 參數 | 規格 |
|---|---|
參數content_type | 規格application/json |
參數required | 規格model, messages |
參數optional | 規格stream |
參數material_types | 規格text, image |
參數conditions | 規格請原樣使用這個 Ailoot 路由選擇值。, 所選的特定模型支援視覺能力時，可透過此協定傳送圖片內容。協定接受請求不代表每個模型都具備圖片處理能力。 |
方法別名： /chat/completions
生命週期： synchronous_or_streamed
方案
費率資訊不會增加請求選項。支援的參數列於所選方法中。
- 快速模式
- 標準費率 選取快速模式時
- flex 模式
- 標準費率 選取 flex 模式時
- 最高推理強度
- 標準費率 最高推理強度採用 default 調整值時
- 顯式快取計價
- 未啟用 請求顯式快取時
- 純文字零費率
- 快取、工具與媒體各依其另行列出的計價條件計費。 適用於純文字輸入與輸出
Ailoot 費率
各設定的價格
| 設定 | 費率表 | 費用 |
|---|---|---|
| 設定基礎 token 費率 | 費率表基本費率 | 費用 輸入 · 輸入 Token $0 / 1K Token 輸出 · 輸出 Token $0 / 1K Token 輸入 · 讀取快取 — / 1K Token 輸入 · 寫入快取 — / 1K Token 輸入 · 寫入快取，1 小時 — / 1K Token |
Ailoot 會在請求前預留估算金額。取得結果後，依實測用量結算最終費用。串流結算採用最終用量紀錄。預留金額與結算的運作方式 →
請求範例
Ailoot Ultra · OpenAI Chat
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "google/gemma-4-31b-it:free", "messages": [{"role": "user", "content": "Explain how a rainbow forms."}]}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
接收並儲存結果
Ailoot Ultra · OpenAI Chat
JSON or SSE
保留所有已完成的結果
請保留所有完整傳回的回應、檔案與內容區塊。
請保留每個內容區塊、工具呼叫 ID、傳回時附帶的思考簽章、所有 SSE 增量資料及完整用量資訊。第一段文字片段並非完整結果。
需要檢查原始回應時
請保留原始 X-Client-Request-ID、回應與標頭。結果不明或為 result_pending_check 時，不代表可以第二次建立。
回應欄位
| 欄位 | 類型 |
|---|---|
欄位choices[] | 類型object |
欄位usage | 類型object |
錯誤與後續步驟
| 回應 | 條件 | 下一步 |
|---|---|---|
回應400 · invalid_request_error | 條件必要欄位、模型選擇值、型別或輸入表示格式無效。 | 下一步準備另一個獨立請求前，請檢視傳回的驗證詳情。 |
回應 | 條件原始請求或結果不明，或需要檢查。 | 下一步請保留原始識別碼與標頭，僅讀取支援的狀態資料或媒體庫紀錄。請勿再次提交建立請求。 |
別名
模型別名
Ailoot Ultra google/gemma-4-31b-it:free
方法路徑別名
/chat/completions
相關呼叫用 ID
FAQ · Google: Gemma 4 31B (free)
- 可以使用哪些輸入與結果？
POST /v1/chat/completions·google/gemma-4-31b-it:free:text,image→text- 請求使用哪些欄位？
POST /v1/chat/completions·google/gemma-4-31b-it:free:model,messages,stream