Gemini 4 Hydrogen Orchestrator là một lựa chọn mô hình trong Google Antigravity, ghép một planner (Gemini 4 Carbon hoặc Argon) với Gemini 4 Hydrogen trong cùng một tác vụ. Planner khám phá và viết kế hoạch, Hydrogen chỉnh sửa code và chạy test, và quyền điều khiển quay lại planner mỗi khi Hydrogen gặp trục trặc. Google cho biết mô hình này đạt tỷ lệ thành công gần bằng Carbon với mức tiêu thụ quota ít hơn 24%.
Nội dung bên dưới: cách hoạt động của vòng trao đổi quyền điều khiển, ý nghĩa của các con số 24% và 19%, những kế hoạch nào được áp dụng, và cách tự xây dựng cơ chế phân chia tương tự với Gemini API. Để nắm các kiến thức cơ bản về mô hình, hãy đọc Gemini 4 Hydrogen là gì.
Gemini 4 Hydrogen Orchestrator là gì?
Orchestrator là một mục trong bảng chọn mô hình của Antigravity, không phải một mô hình riêng biệt. Chọn Orchestrator (Carbon) thì Gemini 4 Carbon sẽ lập kế hoạch còn Gemini 4 Hydrogen sẽ triển khai. Chọn Orchestrator (Argon) thì Gemini 4 Argon sẽ thay Carbon lập kế hoạch. Việc chuyển đổi diễn ra tự động trong từng câu trả lời, bên trong cùng một cuộc hội thoại.
Google ra mắt tính năng này vào ngày 12 tháng 11 năm 2026. Thông báo của Antigravity nêu rõ vấn đề: chạy một mô hình suy luận tiên tiến ở “mọi bước của mọi tác vụ thông thường sẽ làm chậm vòng lặp làm việc của bạn và đốt quota cấp cao.”
Ba điều cần nắm rõ:
- Chỉ có trên Antigravity. Gemini API không có endpoint Orchestrator.
- Cấu hình cố định. Bạn không thể đặt mức thinking cho nó.
- Là một agent duy nhất, không phải một swarm. Nếu cần chạy nhiều agent song song, Antigravity hướng bạn đến subagents,
/swarm, Boost hoặc Teamwork.
Orchestrator hoạt động giữa Carbon và Hydrogen như thế nào?
Tài liệu về mô hình của Antigravity mô tả bốn bước lặp lại trong mỗi lượt:
- Planner lập kế hoạch. Mỗi tin nhắn bạn gửi đều bắt đầu bằng một giai đoạn chỉ đọc. Planner khám phá codebase, làm rõ các điểm mơ hồ và viết một kế hoạch triển khai cụ thể, bao gồm cả các điều kiện nên kích hoạt việc lập kế hoạch lại. Câu hỏi thông thường sẽ được trả lời trực tiếp.
- Hydrogen thực hiện công việc. Nó áp dụng các thay đổi file, viết code, chạy build và test, đồng thời đối chiếu kết quả với kế hoạch.
- Quyền điều khiển quay lại khi gặp trục trặc. Nếu một bước xác minh thất bại hai lần, một interface hoạt động khác với kỳ vọng, hoặc kế hoạch chưa giải quyết xong một lựa chọn thiết kế, Hydrogen sẽ trả quyền điều khiển lại. Planner xem xét trạng thái hội thoại, sửa kế hoạch và giao việc thực thi trở lại cho Hydrogen.
- Planner rà soát tiến độ. Với các tác vụ dài hơn, và mỗi khi bạn gửi tin nhắn giữa chừng, Hydrogen sẽ báo cáo tiến độ. Planner đối chiếu với kế hoạch, sau đó kết thúc, tiếp tục hoặc cập nhật kế hoạch.
Điểm đáng học hỏi trong thiết kế này nằm ở bước 1: planner tự viết các điều kiện kích hoạt việc lập kế hoạch lại. Hydrogen nhận được một danh sách điều kiện bằng văn bản nghĩa là “dừng lại và hỏi.”
Vì sao Google nói rằng các model router tĩnh bị hỏng khi chạy agent trong thời gian dài?
Một router tĩnh đọc prompt đầu tiên của bạn, đoán độ khó của tác vụ, rồi gửi toàn bộ công việc cho mô hình rẻ nhất mà nó nghĩ là có thể hoàn thành. Cách làm này thất bại khi độ khó thay đổi giữa chừng — điều rất bình thường với các agent.

Theo lời Google: các router “bắt đầu gặp vấn đề khi agent chạy lâu hơn, đòi hỏi mức độ phức tạp khác nhau ở các giai đoạn khác nhau, điều thường chỉ được phát hiện khi tác vụ tiến triển.” Một bản nâng cấp dependency có thể trông rất đơn giản cho đến khi một thay đổi API gây lỗi xuất hiện ở bước 7. Router đã chọn mô hình rẻ thì không có đường lùi; router đã chọn mô hình cấp cao thì phải trả giá cấp cao cho mọi lần chạy lại test. Orchestrator quyết định theo từng giai đoạn, theo cả hai chiều.
Các con số 24% quota và 19% tốc độ nghĩa là gì?
Google báo cáo rằng trên Terminal-Bench, Orchestrator “đạt tỷ lệ thành công tác vụ gần bằng Carbon trong khi, trung bình, tiêu thụ ít hơn 24% quota và hoàn thành nhanh hơn 19%.” Hãy đọc con số này với bốn lưu ý:
| Khẳng định | Điều nó nói | Điều nó không nói |
|---|---|---|
| Thành công gần bằng Carbon | Gần bằng Carbon chạy một mình | Không có tỷ lệ thành công chính xác nào được công bố trong cả hai bài đăng |
| Ít hơn 24% quota | Quota kế hoạch của Antigravity, tính trung bình | Không phải số token hay số tiền cụ thể |
| Nhanh hơn 19% | Thời gian hoàn thành tác vụ trung bình | Không phải độ trễ theo từng request |
| Phiên bản benchmark | Terminal-Bench 4.0 trong bài đăng ra mắt của Google, 4.1 trong bài đăng của Antigravity | Phiên bản nào mới là chính xác |
Đây là số liệu của Google trên các lần chạy của Google — một tín hiệu tham khảo chứ không phải dự báo cho repo của bạn. Các tác vụ nặng về lập kế hoạch tiết kiệm ít; các tác vụ nặng về thực thi (nâng cấp 40 package và sửa test) sẽ tiết kiệm nhiều hơn.
Logic chi phí dễ thấy hơn trên API. Gemini 4 Hydrogen có giá 1,50 USD mỗi 1 triệu input token và 7,50 USD mỗi 1 triệu output token. Carbon là 2,00/10,00 USD cho đến ngày 30 tháng 11, sau đó là 4,00/20,00 USD từ ngày 1 tháng 12, theo hướng dẫn giá Gemini 4 Carbon. Thinking token được tính như output, nên mỗi lượt thực thi bạn chuyển từ Carbon sang Hydrogen sẽ giảm chi phí output của lượt đó 62,5% theo giá tháng 12.
Ai có thể dùng Orchestrator, và trên những gói nào?
Orchestrator chỉ đi kèm với Antigravity, và planner bạn nhận được phụ thuộc vào gói Google AI của bạn. Theo tài liệu Antigravity, cập nhật ngày 13 tháng 11 năm 2026:
| Lựa chọn | Planner | Executor | Gói |
|---|---|---|---|
| Orchestrator (Carbon) | Gemini 4 Carbon | Gemini 4 Hydrogen | Google AI Ultra |
| Orchestrator (Argon) | Gemini 4 Argon | Gemini 4 Hydrogen | Google AI Ultra; Google AI Pro trả phí (hoặc dùng thử trên các thiết bị cao cấp đủ điều kiện) |
Người dùng miễn phí và Google AI Plus có Hydrogen độc lập nhưng không có Orchestrator. Với Enterprise, bảng trong tài liệu và thông báo của Antigravity không thống nhất, nên hãy kiểm tra bảng chọn mô hình của chính bạn.
Trong Antigravity CLI, truyền tên lựa chọn trong dấu ngoặc kép:
agy --model "Orchestrator (Carbon)"
agy -p "Add input validation to the signup form and run the tests." --model "Orchestrator (Argon)"
Đang phân vân giữa các planner? Bài so sánh Gemini 4 Carbon vs Argon của chúng tôi sẽ đề cập đến sự đánh đổi này.
Khi nào nên chọn Orchestrator thay vì một mô hình đơn lẻ?
Tài liệu của Google gọi Orchestrator là lựa chọn “mặc định được khuyên dùng” cho công việc hàng ngày:
- Orchestrator: phát triển tính năng, sửa lỗi, tái cấu trúc và debug nhiều file.
- Carbon hoặc Argon đơn lẻ: công việc đòi hỏi độ sâu tối đa ở mọi bước, như thiết kế hệ thống phân tán, truy tìm race condition hoặc di chuyển đa repo.
- Hydrogen đơn lẻ: nâng cấp package, loại bỏ trùng lặp, boilerplate, unit test cho các hàm được định nghĩa rõ ràng, tài liệu và script nhanh.
Nguyên tắc đơn giản: nếu bạn sẽ viết một kế hoạch trước khi bắt đầu, hãy dùng Orchestrator. Nếu bạn chỉ muốn bắt tay vào gõ code, hãy dùng Hydrogen.
Làm thế nào để xây dựng cơ chế chia lập kế hoạch/thực thi tương tự với Gemini API?
Ngoài Antigravity, bạn phải tự xây dựng vòng lặp của Orchestrator. Hướng dẫn What’s new in Gemini 4 Hydrogen của Google mô tả cơ chế này: “Chuyển hướng các lượt lập kế hoạch sang gemini-4-carbon và các lượt thực thi sang gemini-4-hydrogen trong cùng một phiên nhiều lượt bằng previous_interaction_id.” Không cần thay đổi schema request giữa hai mô hình này.

Một phiên bản Python tối giản tái lập quy tắc “thất bại hai lần, trả quyền điều khiển”:
from google import genai
client = genai.Client() # reads GEMINI_API_KEY
def ask(model, prompt, prev=None, level="high"):
return client.interactions.create(
model=model,
input=prompt,
previous_interaction_id=prev,
generation_config={"thinking_level": level},
)
# 1. Carbon plans (read-only) and writes its own re-plan triggers
plan = ask("gemini-4-carbon",
"Plan this task as numbered steps. For each step, list the check "
"that proves it worked and the conditions that require re-planning. "
"Do not write code yet. Task: " + task)
last = plan.id
for step in parse_steps(plan.output_text):
failures = 0
while True:
# 2. Hydrogen executes the step
run = ask("gemini-4-hydrogen", f"Implement step: {step}", prev=last)
last = run.id
ok, log = apply_and_test(run.output_text) # your patch + test runner
if ok:
break
failures += 1
if failures >= 2:
# 3. Escalate to Carbon to repair the plan
fix = ask("gemini-4-carbon",
f"Step failed twice. Test log:\n{log}\nRepair the plan for this step.",
prev=last)
last = fix.id
step, failures = fix.output_text, 0
# 4. Carbon reviews the finished work
review = ask("gemini-4-carbon", "Review the completed work against the plan.", prev=last)
parse_steps và apply_and_test chứa logic build và test của repo bạn. Bốn điều cần làm đúng:
- Đặt mức thinking theo từng vai trò. Carbon mặc định là
mediumvà tối đa làhigh. Hydrogen mặc định làhighvà có thêmxhigh. - Lưu trạng thái trên server.
previous_interaction_idmang lịch sử giữa các mô hình, và caching ngầm giảm giá 95% cho input lặp lại.store=falsesẽ vô hiệu hóa điều này. - Việc chuyển lên cấp trên phải rõ ràng. Sao chép các điều kiện kích hoạt của Orchestrator vào prompt của planner.
- Ghi log token theo từng lượt. Đối tượng
usagebáo cáototal_thought_tokensriêng biệt, nên bạn có thể thấy vai trò nào đang tiêu tốn.
Định dạng request và xác thực được đề cập trong hướng dẫn Gemini 4 Hydrogen API của chúng tôi.
Nếu bạn không muốn tự tay viết vòng lặp, Google cho biết Antigravity SDK cho phép bạn kết nối các agent Hydrogen và Carbon với nhau cùng khả năng kiểm soát vai trò bằng lập trình. Trong demo của họ, các agent Hydrogen phân loại issue và viết code trong khi một agent Carbon đảm nhận việc tái cấu trúc và kiểm tra bảo mật.
Kiểm tra việc bàn giao Carbon sang Hydrogen với Apidog CLI
Một orchestrator tự xây dựng thường hỏng ở khâu bàn giao: một model ID sai, một previous_interaction_id bị bỏ sót, hoặc một mức thinking mà Carbon từ chối. Hãy để coding agent của bạn (Claude Code, Codex, Cursor) xây dựng một test hai bước với Apidog CLI và chạy nó.
Cài đặt một lần:
npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com # pick your agent when prompted
Sau đó đưa cho agent của bạn một prompt:
In Apidog project <projectId>, create an environment "gemini" with base URL
https://generativelanguage.googleapis.com and a secret variable GEMINI_API_KEY.
Build a test scenario with two steps against POST /v1beta/interactions,
both sending the x-goog-api-key header:
1. Planner: model "gemini-4-carbon", thinking_level "high", input asks for a
3-step plan. Assert status 200, status "completed", non-empty output and a
usage object. Extract $.id into plannerId.
2. Executor: model "gemini-4-hydrogen", thinking_level "medium",
previous_interaction_id {{plannerId}}, input "Do step 1 of the plan".
Assert the same checks. Log total_input_tokens, total_thought_tokens and
total_output_tokens for both steps. Run it and summarize failures.
Agent sẽ đọc schema, xác thực payload, viết kịch bản test và chạy nó:
apidog environment create gemini --project <projectId> \
--base-url https://generativelanguage.googleapis.com
apidog cli-schema get test-scenario-update
apidog cli-schema validate test-scenario-update --file scenario.json
apidog test-scenario create --project <projectId> --name "carbon-to-hydrogen"
apidog test-scenario update <scenarioId> --project <projectId> --file scenario.json
apidog test-scenario run <scenarioId> --project <projectId> -e <envId> \
-r cli,json --out-file handoff-{GENERATE_TIME}
Báo cáo JSON hiển thị mức tiêu thụ token của từng vai trò cạnh nhau. Thêm -r junit và cùng lần chạy đó sẽ vào CI, để một thay đổi model ID hoặc một khâu bàn giao lỗi sẽ làm build thất bại; hướng dẫn Apidog CLI CI/CD trình bày pipeline, và Apidog CLI trong Claude Code đề cập đến việc thiết lập agent. Gói Free của Apidog hỗ trợ tối đa 4 người dùng.
Câu hỏi thường gặp
Gemini 4 Hydrogen Orchestrator có sẵn trên Gemini API không? Không. Đây là một lựa chọn trong bảng chọn mô hình của Google Antigravity. Trên API, bạn tự chuyển đổi giữa gemini-4-carbon và gemini-4-hydrogen bằng previous_interaction_id.
Tôi có thể đặt mức thinking cho Orchestrator không? Không. Nó chạy với cấu hình cố định. Hãy chọn trực tiếp Carbon, Argon hoặc Hydrogen nếu bạn cần một mức cụ thể.
Tôi có cần Google AI Ultra không? Với Orchestrator (Carbon), có. Người đăng ký Google AI Pro trả phí nhận được Orchestrator (Argon). Người dùng miễn phí có thể dùng Hydrogen độc lập; xem hướng dẫn Gemini 4 Hydrogen miễn phí của chúng tôi.
Orchestrator có tiết kiệm chi phí trên API không? Cơ chế phân chia tương tự thì có: các lượt thực thi được tính theo giá output của Hydrogen (7,50 USD mỗi 1 triệu) thay vì của Carbon. Hướng dẫn giá Gemini 4 Hydrogen có bảng đầy đủ.
