Gemini 4 Carbon

以原生 Gemini 格式使用 gemini-4-carbon。模型頁提供 Playground 與目前價格。Gemini 4 Carbon 與 Gemini 4 Argon 使用相同的請求格式；Google 的指南說明，切換時只需變更模型 ID。

模型 ID

快速範例

curl https://api.seedrouter.ai/v1beta/models/gemini-4-carbon:generateContent \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"Find the race condition in a retry loop that re-reads a balance before locking it."}]}],"generationConfig":{"thinkingConfig":{"thinkingLevel":"medium"},"maxOutputTokens":32768}}'

模型名稱放在 URL 中。contents 為必填欄位。答案包含原生 candidates、finishReason 與 usageMetadata；請將完整內容部分保留在對話歷史紀錄中，包括 thoughtSignature。複雜提示詞可能需要數分鐘。非串流請求執行超過約 100 秒時，可能在答案回傳前以 HTTP 524 結束，因此長任務請使用 streamGenerateContent；範例也依 Google 的建議，將用戶端逾時設為 15 分鐘。

端點

OpenAPI 規格包含所有巢狀請求與回應 schema。省略選填欄位時採用 API 預設值。SeedRouter 會轉送提交的請求本文，不會過濾未知欄位、移除不支援的欄位，或驗證模型參數值。請求是否被接受，由 Gemini API 決定。

請求參數

URL 將模型固定為 gemini-4-carbon。請求規格包含 11 個頂層欄位。除非標為必填，否則皆為選填；省略欄位與 JSON null 不同。官方 schema 允許時，可為 null 的任意 JSON 會原樣保留。

Gemini 4 Carbon 不支援明確建立的上下文快取（cachedContent 與 cachedContents 資源）。提示詞至少達 4,096 token 時，隱含快取預設開啟。

生成參數

OpenAPI 文件列出每個訊息的巢狀型別、列舉、必要屬性與文件記載的界限。這些 schema 描述官方參數，並非 SeedRouter 的請求允許清單。呼叫端提供的欄位與值都會保留。Schema 接受某欄位，並不代表每個帳戶都支援它。列出的思考層級不含 minimal。Google 說明，此模型會忽略 temperature、topP 與 topK；candidateCount 並非官方控制項。若透過原生 JSON 提交，仍會原樣傳遞，交由 Gemini API 處理。對話應以使用者內容結尾；僅含函式回應的使用者回合仍屬有效。

長文分段生成

Gemini 4 Carbon 單次串流回應最多回傳 65,536 token，非串流回應最多回傳 32,768 token。若需更長輸出，請將 maxOutputTokens 設為大於 65,536，並自行發起接續請求：

1. 傳送請求。若回應以 finishReason: "CONTINUATION" 結束，讀取 candidates[0].continuationToken。
2. 將該值填入頂層 continuationToken 欄位，再次傳送同一個請求。請勿將部分輸出附加至 contents；token 會攜帶模型狀態，包括思考狀態。
3. 重複上述步驟，直到 finishReason 為 STOP 或 MAX_TOKENS。

{
  "contents": [{"role": "user", "parts": [{"text": "Write a complete, rigorous proof of the prime number theorem."}]}],
  "generationConfig": {"thinkingConfig": {"thinkingLevel": "high"}, "maxOutputTokens": 262144},
  "continuationToken": "TOKEN_FROM_THE_PREVIOUS_RESPONSE"
}

某次請求若全部用於思考，可能回傳空文字並以 CONTINUATION 結束，這是正常進展。每次請求都會將提示詞與先前生成的所有內容重新傳送給模型，因此之後每次請求都會重新計算輸入 token。SeedRouter 將每次請求個別計費。Interactions API 的伺服器端 background 模式不屬於此端點。

結構化輸出

{
  "contents": [{"parts": [{"text": "Return a JSON object with ok set to true."}]}],
  "generationConfig": {
    "thinkingConfig": {"thinkingLevel": "low"},
    "maxOutputTokens": 32768,
    "responseMimeType": "application/json",
    "responseJsonSchema": {
      "type": "object",
      "properties": {"ok": {"type": "boolean"}},
      "required": ["ok"]
    }
  }
}

舊版 responseSchema 與 responseJsonSchema 欄位不能同時使用，兩者都須設定 responseMimeType: "application/json"。較新的 responseFormat.text schema 同樣須指定 JSON。該訊息內請使用 REST 列舉拼法（APPLICATION_JSON 與 TEXT_PLAIN）。請求會原樣傳遞；媒體 MIME 類型與任意函式 JSON 都不會被改寫。

函式與內建工具

使用 tools[].functionDeclarations，提供名稱及 parameters 或 parametersJsonSchema 其中之一，不可兩者並用。函式選擇設定位於 toolConfig.functionCallingConfig；allowedFunctionNames 須搭配 ANY 或 VALIDATED，且名稱必須已宣告。

應用程式負責執行回傳的函式，並在下一輪對話提供結果。請保留每個原始 thoughtSignature、函式呼叫與函式回應。序列化不透明的函式引數時，請勿對數值識別碼進行四捨五入。

Google 為此模型列出 Search、Maps、程式碼執行、URL 上下文、檔案搜尋與電腦操作。檔案搜尋資源需要處理該請求的憑證具備存取權限。原生 MCP 設定出現在通用 schema 中，但尚未確立此模型能否使用。Google Maps 要求輸入僅限文字；將 Maps 與媒體結合前，請確認官方 API 限制。使用 grounding 時，Google 會將內部工具指令與函式宣告計入輸入 token。Playground 不會執行你的自訂函式。

多模態輸入與安全設定

contents[].parts[] 中的每個項目只能包含一種承載內容：文字、內嵌媒體、檔案參照、函式呼叫／回應，或執行部分。也可附帶簽章或媒體中繼資料。輸入支援文字、圖片、音訊、影片與 PDF；輸出僅限文字。模型不產生圖片或音訊，也沒有 Live API。

內嵌位元組使用 inlineData.mimeType 與 base64 data。檔案參照使用 fileData.mimeType 與 fileUri。URL 語法有效並不代表模型能擷取它。影片中繼資料可指定開始／結束偏移量，以及大於零且不超過 24 的 fps。若要使用代理式影片理解，請為個別內容部分設定 mediaProcessing: "AGENTIC"，放在影片的 fileData 或 inlineData 旁；預設採用靜態處理。videoMetadata 僅包含 startOffset、endOffset 與 fps。

安全設定採用官方原生格式，並透過 API 原樣傳遞。在 Playground 中，全部四個類別都須設為 BLOCK_MEDIUM_AND_ABOVE 或更嚴格的層級；較低的門檻僅能透過 API 使用。

JSON 回應與串流

generateContent 回傳原生 JSON。streamGenerateContent?alt=sse 會在 SSE data: 事件中輸出原生 JSON。重要欄位包括 candidates[].content.parts、finishReason、continuationToken、safetyRatings、groundingMetadata、promptFeedback、modelVersion、responseId 與 usageMetadata。

在對話歷史紀錄中保留完整原生內容。思考摘要與思考簽章不同。連線中斷並不代表生成失敗或完成；再次送出請求前，請先檢視部分結果與帳戶紀錄。串流用量是累計值，請使用最新計數值，不要將每個區塊相加。

用量與價格

promptTokenCount 包含快取輸入。cachedContentTokenCount 依快取輸入費率計費，不會再以未快取輸入重複計費。計費輸出包含 candidatesTokenCount 加上 thoughtsTokenCount。Gemini 4 Carbon 每輪比 Gemini 4 Argon 使用更多思考 token，因此相同提示詞預期會產生更多輸出用量。

此模型沒有隨上下文長度變動的價格級距。Flex 與 Priority 是不同的處理層級。回報為 Standard 的結果不得加收 Priority 費用；若要求 Priority 回應，卻無法確認實際層級，則採用 Standard token 費率。Google Search 與 Maps 的 grounding 依查詢個別計費，和生成 token 費用分開計算。失敗的請求不收費。請參閱即時價格表。

帳戶分組

在 Playground 選擇可用分組，或使用選填的 API 標頭並填入完全相符的分組名稱：

X-SeedRouter-Group: GROUP_NAME

所選分組決定價格與可用容量；明確選擇後不會在未提示的情況下切換到其他分組。省略標頭或使用 auto，即可保留 API 金鑰的預設行為。

不生成回應，也能查詢 API 金鑰的可用分組：

curl "https://api.seedrouter.ai/api/seedrouter/llm/groups?model=gemini-4-carbon" \
  -H "Authorization: Bearer YOUR_SEEDROUTER_KEY"

驗證狀態

控制項與文件遵循官方原生格式。參數驗證由 Gemini API 負責。2026 年 11 月 11 日的正式環境請求（每項各嘗試一次）觀察到以下結果：

處理層級、mediaProcessing: "AGENTIC" 與接續 token，仍須在目前版本部署至正式環境後進一步檢查。此處未宣稱與 Gemini 4 Argon 有任何實測品質或延遲比較結果。

參考資料

• Google 模型規格
• Gemini 4 Carbon 的新功能
• 透過 generateContent 實現長文分段生成
• 思考
• 價格
• GenerateContent REST 參考文件