Gemini 4 Carbon

Dùng gemini-4-carbon với định dạng Gemini gốc. Trang mô hình có Playground và giá hiện tại. Gemini 4 Carbon dùng cùng định dạng yêu cầu với Gemini 4 Argon; hướng dẫn của Google cho biết chỉ cần đổi ID mô hình để chuyển giữa hai mô hình.

ID mô hình

Ví dụ nhanh

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}}'

Mô hình được đặt trong URL. contents là trường bắt buộc. Câu trả lời có các trường gốc candidates, finishReason và usageMetadata; hãy giữ nguyên toàn bộ các phần nội dung, bao gồm thoughtSignature, trong lịch sử hội thoại. Prompt khó có thể chạy trong vài phút. Yêu cầu không truyền luồng chạy lâu hơn khoảng 100 giây có thể kết thúc với HTTP 524 trước khi câu trả lời đến, nên hãy dùng streamGenerateContent cho tác vụ dài; các ví dụ cũng đặt thời gian chờ phía máy khách là 15 phút theo khuyến nghị của Google.

Điểm cuối

Đặc tả OpenAPI bao gồm mọi lược đồ yêu cầu và phản hồi lồng nhau. Các trường tùy chọn dùng giá trị mặc định của API khi bị bỏ qua. SeedRouter chuyển tiếp nguyên phần thân đã gửi, không lọc trường không xác định, loại bỏ trường không được hỗ trợ hay xác thực giá trị tham số mô hình. Gemini API quyết định có chấp nhận yêu cầu hay không.

Tham số yêu cầu

URL cố định mô hình là gemini-4-carbon. Đặc tả yêu cầu có 11 trường cấp cao nhất. Các trường là tùy chọn trừ khi được đánh dấu bắt buộc; bỏ qua trường khác với JSON null. JSON tùy ý có thể nhận null được giữ nguyên ở những nơi lược đồ chính thức cho phép.

Gemini 4 Carbon không hỗ trợ lưu ngữ cảnh vào bộ nhớ đệm tường minh (cachedContent và tài nguyên cachedContents). Bộ nhớ đệm ngầm định được bật mặc định cho prompt có ít nhất 4.096 token.

Tham số tạo nội dung

Tài liệu OpenAPI liệt kê kiểu lồng nhau, enum, thuộc tính bắt buộc và giới hạn được ghi trong tài liệu cho từng thông điệp. Các lược đồ mô tả tham số chính thức, không phải danh sách trường yêu cầu được SeedRouter cho phép. Trường và giá trị do bên gọi gửi được giữ nguyên. Một trường được lược đồ chấp nhận không chứng minh mọi tài khoản đều hỗ trợ. minimal không phải mức suy luận được liệt kê. Google cho biết temperature, topP và topK bị bỏ qua trên mô hình này; candidateCount không phải thiết lập chính thức. Nếu được gửi trong JSON gốc, chúng vẫn chuyển tiếp nguyên trạng để Gemini API xử lý. Kết thúc hội thoại bằng nội dung người dùng; lượt người dùng chỉ có phản hồi hàm vẫn hợp lệ.

Tạo câu trả lời dài theo từng phần

Một phản hồi Gemini 4 Carbon trả về tối đa 65.536 token khi truyền luồng và tối đa 32.768 token khi không truyền luồng. Để tạo dài hơn, đặt maxOutputTokens trên 65.536 và tự tiếp tục câu trả lời:

1. Gửi yêu cầu. Nếu phản hồi kết thúc với finishReason: "CONTINUATION", đọc candidates[0].continuationToken.
2. Gửi lại cùng yêu cầu với giá trị đó trong trường cấp cao nhất continuationToken. Không thêm đầu ra từng phần vào contents; token mang trạng thái của mô hình, bao gồm suy luận.
3. Lặp lại đến khi finishReason là STOP hoặc 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"
}

Một phần chỉ dành cho suy luận có thể trả về văn bản rỗng với CONTINUATION; đó là tiến trình bình thường. Mỗi phần gửi lại prompt cùng toàn bộ nội dung đã tạo đến thời điểm đó cho mô hình, nên token đầu vào được tính lại ở mỗi phần tiếp theo. SeedRouter tính phí từng phần như một yêu cầu riêng. Chế độ background phía máy chủ của Interactions API không thuộc điểm cuối này.

Đầu ra có cấu trúc

{
  "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"]
    }
  }
}

Không thể dùng đồng thời hai trường cũ responseSchema và responseJsonSchema. Cả hai yêu cầu responseMimeType: "application/json". Lược đồ responseFormat.text mới hơn cũng phải chỉ định JSON. Dùng cách viết enum của REST (APPLICATION_JSON và TEXT_PLAIN) trong thông điệp đó. Yêu cầu được chuyển tiếp nguyên trạng; kiểu MIME của nội dung đa phương tiện và JSON tùy ý của hàm không bị viết lại.

Hàm và công cụ tích hợp

Dùng tools[].functionDeclarations với tên và một trong hai trường parameters hoặc parametersJsonSchema, không dùng cả hai. Cấu hình lựa chọn hàm nằm trong toolConfig.functionCallingConfig; allowedFunctionNames yêu cầu ANY hoặc VALIDATED cùng các tên đã khai báo.

Ứng dụng của bạn thực thi hàm được trả về và cung cấp kết quả trong lượt hội thoại tiếp theo. Giữ nguyên từng thoughtSignature, lời gọi hàm và phản hồi hàm ban đầu. Không làm tròn định danh dạng số khi tuần tự hóa các đối số hàm không cần diễn giải.

Google liệt kê Search, Maps, thực thi mã, ngữ cảnh URL, File Search và Computer Use cho mô hình này. Tài nguyên File Search yêu cầu quyền truy cập theo thông tin xác thực phục vụ yêu cầu. Cấu hình MCP gốc xuất hiện trong lược đồ chung nhưng chưa xác nhận khả năng dùng trên mô hình này. Google Maps yêu cầu đầu vào chỉ là văn bản; kiểm tra các hạn chế API chính thức trước khi kết hợp Maps với nội dung đa phương tiện. Khi dùng grounding, Google tính hướng dẫn nội bộ của công cụ và khai báo hàm là token đầu vào. Playground không thực thi hàm tùy chỉnh của bạn.

Đầu vào đa phương thức và an toàn

Một mục contents[].parts[] chứa đúng một loại dữ liệu: văn bản, nội dung đa phương tiện nội tuyến, tham chiếu tệp, lời gọi/phản hồi hàm hoặc phần thực thi. Mục này cũng có thể mang chữ ký hay siêu dữ liệu đa phương tiện. Đầu vào hỗ trợ văn bản, hình ảnh, âm thanh, video và PDF; đầu ra chỉ là văn bản. Mô hình không tạo hình ảnh hay âm thanh và không có Live API.

Với byte nội tuyến, dùng inlineData.mimeType và data dạng base64. Với tham chiếu tệp, dùng fileData.mimeType và fileUri. URL đúng cú pháp không chứng minh mô hình có thể truy xuất. Siêu dữ liệu video có thể chỉ định độ lệch bắt đầu/kết thúc và fps dương không quá 24. Tính năng hiểu video theo kiểu agentic được chọn cho từng phần bằng mediaProcessing: "AGENTIC" cạnh fileData hoặc inlineData của video; xử lý tĩnh là mặc định. videoMetadata chỉ chứa startOffset, endOffset và fps.

Thiết lập an toàn dùng định dạng gốc chính thức và được chuyển tiếp nguyên trạng qua API. Trong Playground, cả bốn danh mục phải được đặt thành BLOCK_MEDIUM_AND_ABOVE hoặc nghiêm ngặt hơn; ngưỡng thấp hơn chỉ dùng qua API.

Phản hồi JSON và truyền luồng

generateContent trả về JSON gốc. streamGenerateContent?alt=sse phát JSON gốc trong các sự kiện SSE data:. Các trường quan trọng gồm candidates[].content.parts, finishReason, continuationToken, safetyRatings, groundingMetadata, promptFeedback, modelVersion, responseId và usageMetadata.

Giữ nguyên toàn bộ nội dung gốc trong lịch sử hội thoại. Bản tóm tắt suy luận khác với chữ ký suy luận. Mất kết nối không chứng minh lượt tạo đã thất bại hay hoàn tất; hãy kiểm tra kết quả từng phần và bản ghi tài khoản trước khi gửi yêu cầu khác. Mức sử dụng trong luồng là lũy kế, vì vậy dùng bộ đếm mới nhất thay vì cộng từng đoạn.

Mức sử dụng và giá

promptTokenCount bao gồm đầu vào từ bộ nhớ đệm. cachedContentTokenCount được tính theo giá đầu vào từ bộ nhớ đệm, không bị tính lại như đầu vào không từ bộ nhớ đệm. Đầu ra tính phí gồm candidatesTokenCount cộng thoughtsTokenCount. Gemini 4 Carbon dùng nhiều token suy luận hơn mỗi lượt so với Gemini 4 Argon, nên hãy dự kiến mức sử dụng đầu ra cao hơn cho cùng prompt.

Mô hình này không có bước tăng giá theo độ dài ngữ cảnh. Flex và Priority là các cấp xử lý riêng. Kết quả được báo cáo là Standard không được chịu phụ phí Priority; nếu yêu cầu Priority không có phản hồi xác nhận cấp thực tế, giá token Standard được áp dụng. Grounding bằng Google Search và Maps được tính phí theo từng truy vấn, tách biệt với token tạo nội dung. Yêu cầu thất bại không bị tính phí. Xem bảng giá trực tiếp.

Nhóm tài khoản

Chọn nhóm khả dụng trong Playground hoặc dùng tiêu đề API tùy chọn với tên nhóm chính xác:

X-SeedRouter-Group: GROUP_NAME

Nhóm được chọn quyết định giá và năng lực khả dụng; lựa chọn tường minh không âm thầm chuyển sang nhóm khác. Bỏ tiêu đề hoặc dùng auto để giữ hành vi mặc định của khóa API.

Kiểm tra các nhóm khả dụng của khóa API mà không tạo câu trả lời:

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

Trạng thái xác minh

Các thành phần điều khiển và tài liệu tuân theo định dạng gốc chính thức. Gemini API chịu trách nhiệm xác thực tham số. Các yêu cầu trong môi trường thực tế vào ngày 11 tháng 11 năm 2026 (mỗi mục một lần thử) ghi nhận:

Các cấp xử lý, mediaProcessing: "AGENTIC" và token tiếp tục cần kiểm tra bổ sung sau khi bản phát hành hiện tại được triển khai vào môi trường thực tế. Không đưa ra so sánh chất lượng hay độ trễ đã đo với Gemini 4 Argon.

Tài liệu tham khảo

• Đặc tả mô hình Google
• Điểm mới trong Gemini 4 Carbon
• Tạo câu trả lời dài theo từng phần bằng generateContent
• Suy luận
• Giá
• Tài liệu tham khảo REST GenerateContent