Claude Opus 5.5 已在 SeedRouter 上線

Text

Gemini 4 Argon

View Markdown

原生 Gemini 請求、多模態輸入、思考、工具、串流與接續生成,並說明目前的驗證範圍。

以原生 Gemini 格式使用 gemini-4-argon。模型頁 提供 Playground 與目前費率;發表指南 說明可用範圍。

模型 ID

模型 ID上下文視窗預設思考強度
gemini-4-argon1,048,576 tokenmedium

快速範例

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 預設值。未知欄位與官方不支援的欄位會被捨棄;支援欄位的無效值仍會產生錯誤。

參數

名稱型別必填預設值說明
contentsobject[]是—必填的對話陣列;parts 承載文字、媒體與工具結果
systemInstructionobject否—僅含文字的系統指令
generationConfigobject否—輸出預算、思考、結構化輸出、停止條件與媒體設定
toolsobject[]否—函式與內建工具定義
toolConfigobject否—函式選擇、檢索設定與伺服器工具部分
safetySettingsobject[]否—不重複的安全類別與門檻配對
continuationTokenstring否—最新候選回應中的不透明接續 token
serviceTierenum否standardunspecified、standard、flex、priority;預設為 standard
labelsobject否—小寫標籤鍵與值,各最多 63 個 Unicode 字元
storeboolean否—請求記錄偏好,不提供已儲存對話的檢索功能
modelstring否—選填的請求本文資源名稱;模型由 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"