Gemini 4 Hydrogen

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

ID mô hình

Kiểm tra danh sách mô hình và các bậc khả dụng trước khi chạy ví dụ. Dùng ID gọi đầy đủ do cơ chế khám phá trả về khi bậc Default không khả dụng.

Ví dụ nhanh

curl https://api.seedrouter.ai/v1beta/models/gemini-4-hydrogen: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":"high"},"maxOutputTokens":65536}}'

Mô hình nằm trong URL. contents là bắt buộc. Câu trả lời có candidates, finishReason và usageMetadata gốc; giữ đầy đủ các phần nội dung, bao gồm thoughtSignature, cho lịch sử hội thoại. Prompt khó có thể chạy trong vài phút. Google khuyến nghị thời gian chờ phía máy khách là 20 phút. Dùng streaming để nhận đầu ra ngay khi có.

Endpoint

Đặc tả OpenAPI bao gồm mọi schema yêu cầu và phản hồi lồng nhau. Trường tùy chọn dùng giá trị mặc định của API khi bị bỏ qua. API gốc công khai giữ nguyên phần thân được gửi để Gemini xác thực. Playground cũng kiểm tra các ràng buộc trong tài liệu trước khi gửi và thực thi thiết lập an toàn của nó.

Tham số yêu cầu

URL cố định mô hình là gemini-4-hydrogen. Hợp đồng 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 khác với JSON null. JSON tùy ý có thể nhận null được giữ nguyên khi schema chính thức cho phép.

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

Tham số tạo phản hồi

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 mọi thông điệp. Các schema mô tả tham số chính thức; chúng không phải danh sách cho phép yêu cầu của SeedRouter. Trường và giá trị do bên gọi cung cấp được giữ nguyên. Trường được schema chấp nhận không chứng minh mọi tài khoản đều được hỗ trợ. Suy luận minimal không nằm trong các mức được liệt kê. Google cho biết temperature, topP, topK và candidateCount đã ngừng khuyến nghị và nên được loại bỏ; các giá trị lấy mẫu tùy chỉnh bị bỏ qua. Nếu gửi trong JSON gốc, chúng vẫn được chuyển nguyên trạng để Gemini API xử lý.

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

Một phản hồi Gemini 4 Hydrogen trả về tối đa 65.536 token khi streaming và tối đa 65.536 token khi không streaming. Để đi xa 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 continuationToken cấp cao nhất. Không nối đầu ra từng phần vào contents; token mang trạng thái mô hình, bao gồm suy luận.
3. Lặp lại cho đế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 xử lý dành hoàn toàn 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ủa bạn cùng toàn bộ nội dung đã tạo tới lúc đó cho mô hình, nên token đầu vào được đếm lại ở mọi phần sau. SeedRouter tính phí mỗi 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 endpoint 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": 65536,
    "responseMimeType": "application/json",
    "responseJsonSchema": {
      "type": "object",
      "properties": {"ok": {"type": "boolean"}},
      "required": ["ok"]
    }
  }
}

Không thể dùng cùng các trường kiểu cũ responseSchema và responseJsonSchema. Cả hai yêu cầu responseMimeType: "application/json". Schema responseFormat.text mới hơn cũng phải chỉ định JSON. Dùng cách viết enum REST (APPLICATION_JSON và TEXT_PLAIN) trong thông điệp đó. Yêu cầu được chuyển nguyên trạng; kiểu MIME đa phương tiện và JSON hàm tùy ý 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. Lựa chọn hàm nằm trong toolConfig.functionCallingConfig; allowedFunctionNames yêu cầu ANY hoặc VALIDATED và các tên đã khai báo.

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

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 có trong schema chung, nhưng khả năng sử dụng cho mô hình này chưa được xác lập. Kiểm tra hạn chế chính thức của từng công cụ trước khi kết hợp với đa phương tiện. Khi dùng grounding, Google tính chỉ dẫn công cụ nội bộ và khai báo hàm vào 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 payload: văn bản, đa phương tiện nội tuyến, tham chiếu tệp, lệnh gọi/phản hồi hàm hoặc phần thực thi. Mục đó cũng có thể mang chữ ký hoặc 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 base64. Với tham chiếu tệp, dùng fileData.mimeType và fileUri. URL hợp lệ về 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 lớn hơn 24. Khả năng hiểu video theo tác nhân đượ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 qua API nguyên trạng. Trong Playground, cả bốn danh mục phải đặt ở BLOCK_MEDIUM_AND_ABOVE hoặc nghiêm ngặt hơn; ngưỡng thấp hơn chỉ khả dụng qua API.

Phản hồi JSON và streaming

generateContent trả về JSON gốc. streamGenerateContent?alt=sse phát JSON gốc trong 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ữ 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 quá trình tạo đã thất bại hay hoàn tất; kiểm tra kết quả từng phần và hồ sơ tài khoản trước khi gửi yêu cầu khác. Mức sử dụng luồng là lũy kế, vì vậy dùng bộ đếm mới nhất thay vì cộng mọi khối.

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, thay vì bị tính lại như đầu vào không được lưu đệm. Đầu ra tính phí gồm candidatesTokenCount cộng thoughtsTokenCount. Hydrogen mặc định suy luận high. Đặt mức rõ ràng khi so sánh mức sử dụng với mô hình khác.

Mô hình này không có bậc giá theo độ dài ngữ cảnh. Giá SeedRouter hiện tại dùng mức giá token Standard; chiết khấu Flex và phụ phí Priority chưa được cấu hình cho tích hợp này. Hỗ trợ các bậc xử lý đó vẫn cần xác minh. Grounding Google Search có thể phát sinh phí theo truy vấn ngoài mức sử dụng token; kiểm tra giá công cụ trước khi bật. 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

Bậc Default dùng ID mô hình gemini-4-hydrogen không có hậu tố. Các bậc bổ sung dùng gemini-4-hydrogen:GROUP_NAME trong URL. Playground chọn bậc khả dụng; API cũng chấp nhận header được chỉ định rõ:

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 rõ ràng không âm thầm chuyển sang nhóm khác. Bỏ header hoặc dùng auto để giữ hành vi mặc định của API key.

Kiểm tra các nhóm khả dụng của API key mà không tạo phản hồi:

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

Trạng thái xác minh

Tài liệu chính thức được kiểm tra ngày 13 tháng 11 năm 2026. Ngày đó, ba kiểm tra có phí qua SeedRouter, mỗi kiểm tra một lần thử, đều đạt: JSON có cấu trúc với suy nghĩ low, SSE với suy nghĩ xhigh và gọi hàm đã khai báo với suy nghĩ low. Token đầu vào, đầu ra và suy nghĩ được báo cáo khớp với phí ghi nhận theo giá công bố. Hiểu phương tiện, bám nguồn, Computer Use, tiếp tục/giải mã dài, các trường chung khác và tầng xử lý vẫn chưa được xác minh. Các kiểm tra này không xác lập chất lượng hay độ trễ so sánh.

Tài liệu tham khảo

• Đặc tả mô hình Google
• Có gì mới trong Gemini 4 Hydrogen
• Tạo câu trả lời dài với generateContent
• Suy luận
• Giá
• Tham chiếu REST GenerateContent