Text
Gemini 4 Argon
原生 Gemini 請求、多模態輸入、思考、工具、串流與接續生成,並說明目前的驗證範圍。
以原生 Gemini 格式使用 gemini-4-argon。模型頁 提供 Playground 與目前費率;發表指南 說明可用範圍。
模型 ID
| 模型 ID | 上下文視窗 | 預設思考強度 |
|---|---|---|
gemini-4-argon | 1,048,576 token | medium |
快速範例
curl https://api.seedrouter.ai/v1beta/models/gemini-4-argon:generateContent \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contents":[{"role":"user","parts":[{"text":"Explain a mutex in one sentence."}]}],"generationConfig":{"thinkingConfig":{"thinkingLevel":"low"},"maxOutputTokens":256}}'模型名稱放在 URL 中,contents 為必填欄位。回應包含原生 candidates、finishReason 與 usageMetadata。請將完整的內容部分保留在對話紀錄中,包括 thoughtSignature。
端點
| 操作 | 端點 |
|---|---|
| JSON 回應 | POST /v1beta/models/gemini-4-argon:generateContent |
| 伺服器傳送事件 | POST /v1beta/models/gemini-4-argon:streamGenerateContent?alt=sse |
OpenAPI 規格 包含所有巢狀請求與回應 schema。省略選填欄位時採用 API 預設值。未知欄位與官方不支援的欄位會被捨棄;支援欄位的無效值仍會產生錯誤。
參數
| 名稱 | 型別 | 必填 | 預設值 | 說明 |
|---|---|---|---|---|
contents | object[] | 是 | — | 必填的對話陣列;parts 承載文字、媒體與工具結果 |
systemInstruction | object | 否 | — | 僅含文字的系統指令 |
generationConfig | object | 否 | — | 輸出預算、思考、結構化輸出、停止條件與媒體設定 |
tools | object[] | 否 | — | 函式與內建工具定義 |
toolConfig | object | 否 | — | 函式選擇、檢索設定與伺服器工具部分 |
safetySettings | object[] | 否 | — | 不重複的安全類別與門檻配對 |
continuationToken | string | 否 | — | 最新候選回應中的不透明接續 token |
serviceTier | enum | 否 | standard | unspecified、standard、flex、priority;預設為 standard |
labels | object | 否 | — | 小寫標籤鍵與值,各最多 63 個 Unicode 字元 |
store | boolean | 否 | — | 請求記錄偏好,不提供已儲存對話的檢索功能 |
model | string | 否 | — | 選填的請求本文資源名稱;模型由 URL 固定 |
generationConfig 包含 maxOutputTokens、thinkingConfig、stopSequences、responseFormat、舊版 responseMimeType/responseSchema/responseJsonSchema、responseModalities、mediaResolution、seed、presencePenalty、frequencyPenalty、responseLogprobs、logprobs、enableEnhancedCivicAnswers、enableAffectiveDialog、translationConfig 與 audioTranscriptionConfig。尚未確認模型特定行為的通用欄位,仍需進行功能驗證。
- 思考層級:
low、medium、high,預設為medium。無法關閉思考。includeThoughts用於要求思考摘要。已棄用的thinkingBudget可單獨使用,但不能與thinkingLevel同時設定。 - 輸入、思考與輸出共用 1,048,576 token。
maxOutputTokens包含思考 token;剩餘上下文可能縮減實際可用的預算。 - 原生 REST 單次請求的輸出上限與預設值為 32,768 token,串流為 65,536。較長的輸出透過接續請求完成。官方文件對首次非串流請求超過 32,768 的情況有不同說法;此串接不會將該數值視為整個生成過程的上限。
stopSequences最多五項。logprobs範圍為 0 至 20,且必須設定responseLogprobs: true。responseSchema與responseJsonSchema互斥,均須設定responseMimeType: "application/json"。新請求可使用下方的responseFormat.text。responseModalities只能包含TEXT。Temperature、top-p、top-k 與候選數量不是 Argon 的有效控制項。不支援明確建立的cachedContent、圖片生成與語音生成。
結構化輸出與工具
{
"contents": [{"parts": [{"text": "Return a JSON object with ok set to true."}]}],
"generationConfig": {
"thinkingConfig": {"thinkingLevel": "low"},
"maxOutputTokens": 256,
"responseFormat": {
"text": {
"mimeType": "APPLICATION_JSON",
"schema": {"type": "object", "properties": {"ok": {"type": "boolean"}}, "required": ["ok"]}
}
}
}
}函式透過 tools[].functionDeclarations 定義。allowedFunctionNames 要求模式為 ANY 或 VALIDATED,且名稱已宣告。請維持函式呼叫、回應與簽章的原始順序。Google Search、Maps、程式碼執行、URL context、File Search 與 Computer Use 都是官方功能;資源存取、費用與行為仍須針對預期操作驗證。Playground 不會在本機執行工具。
媒體與安全設定
原生 parts 透過 inlineData 或 fileData 接受文字、圖片、音訊、影片與 PDF 輸入。每個部分只能包含一種內容類型,可附上思考簽章與媒體中繼資料。全域 mediaResolution 與個別部分的解析度設定不同。影片支援 STATIC 與 AGENTIC 處理;videoMetadata.fps 必須大於 0 且不超過 24。
Playground 接受最大 12 MiB 的 JSON 請求。這是應用程式的傳輸限制,不是模型的媒體上限。大型媒體請使用帳戶支援的檔案參照。檔案資源與外部擷取媒體的官方限制不同,此處尚未驗證其可用性。
公開 API 的安全設定遵循原生規格。Playground 要求四個主要安全類別採用中等或更嚴格的攔截設定;較低門檻僅能透過 API 設定,管理員除外。
串流與接續生成
從 SSE 串流讀取原生 JSON 事件。保留所有內容部分,包括工具與思考中繼資料。同一串流的用量計數是累計值,請使用最後一個用量物件,不要將每個事件相加。
候選回應傳回 continuationToken 時,請原樣保留。對於 CONTINUATION,重新傳送原始 contents、系統指令、工具與生成設定,並將最新 token 放在最外層。不要將部分輸出加到 contents。對於 MAX_TOKENS,繼續前請提高輸出預算。Playground 會準備接續請求供你檢查,只有再次按下「傳送」才會送出。
每次接續都是獨立請求,有各自的用量與費用。若實作重新連線,請保留檢查點;不要假設中斷的串流已完成。Playground 會保留原生回應,方便檢查所有欄位。
用量與目前驗證狀態
輸入用量包含快取輸入;計費輸出包含候選回應與思考 token。請參閱模型頁目前的費率及帳戶用量紀錄。失敗的請求不收費。
2026 年 10 月 14 日的本機檢查驗證了文字串流、結構化 JSON、含簽章的函式呼叫與結果回傳、程式碼執行、Google Search 與 URL context、圖片/影片/PDF 理解、思考輸出及停止序列。音訊輸入獲得接受,但樣本中的部分內容轉錄有誤。
logprobs 遭明確拒絕。包含 maxOutputTokens: 32769 的請求在 JSON 與 SSE 檢查中均失敗。有效與無效的 continuationToken 都傳回了答案,因此正確的接續生成尚未驗證。服務層級選項與 seed 獲得接受,但沒有證據證明它們產生了效果。Maps、File Search、Computer Use、agentic video 與外部檔案參照仍未測試。
這些有限的檢查無法證明所有參數組合都有效,也無法證明正式環境的可用性。完整規格請使用原生格式;OpenAI 相容格式是另一個功能子集,不提供 long decode。
參考資料
選用 LLM 群組
登入此模型的 Playground 即可查看可用群組。可選項目取決於您的帳號權限與所選模型。Playground 使用您的登入工作階段,不需要提供 API 金鑰。
API 呼叫沿用您的 API 金鑰與模型 ID。若要選擇群組,請在選用的 X-SeedRouter-Group 請求標頭中填入群組的完整名稱。將下方的 GROUP_NAME 換成 Playground 顯示的名稱。不傳此標頭或使用 auto,即可保留金鑰的預設行為。
X-SeedRouter-Group: GROUP_NAME受限制的 API 金鑰可選群組可能比 Playground 少。請求依所選群組的價格計費;若該群組無法使用,不會切換到其他群組。此選項支援 HTTP LLM 呼叫(包含 SSE),不適用於 WebSocket、圖片或影片呼叫。
若要查詢特定 API 金鑰可用的群組,而不產生模型回應,可使用此唯讀端點。data[].id 是請求標頭的值;ratio 是該帳號在此群組的價格倍率。auto 項目反映目前預設選擇的估算值;沒有可用的預設群組時,其倍率為 null。呼叫模型時會再次確認群組是否可用。
curl "https://api.seedrouter.ai/api/seedrouter/llm/groups?model=gemini-4-argon" \
-H "Authorization: Bearer YOUR_SEEDROUTER_KEY"