Huny's Dev Blog
huny.dev

Gemini 4 Hydrogen GA: Flash 전환에서 달라지는 기본값과 비용

Gemini 4 Hydrogen GA와 Antigravity 기본 모델 변경을 바탕으로 Flash 요청 호환성, 추론 기본값, 통합 토큰 예산, 캐시와 비용을 점검합니다.

Hun Jang
Hun Jang Nov 13, 2026

추론 단계와 토큰 예산을 명시적으로 관리하는 모델 전환을 표현한 AI 생성 편집 이미지. 실제 제품 화면이나 구조도는 아닙니다.

Google이 November 12, 2026 Gemini 4 Hydrogen을 정식 공개했습니다. 이번에 먼저 볼 것은 성능 순위보다 기존 Flash 요청의 호환성과 관리형 에이전트의 기본 모델 변경입니다. 모델 문자열만 교체하면 오류가 나거나, 오류 없이 기존 설정의 의미가 달라질 수 있습니다. 공식 변경 기록

이 글은 November 13, 2026 한국 시간 기준 공식 문서를 확인한 운영 점검 가이드입니다. 실제 API 성능이나 비용을 실측한 벤치마크는 아닙니다.

먼저 적용 대상을 구분하자

  • Gemini 3.8 Flash 또는 이전 버전에서 전환: 아래 요청 필드와 토큰 예산을 함께 점검합니다.
  • Gemini 4 Carbon·Argon과 혼용: 공식 가이드는 요청 스키마 변경이 필요 없다고 안내하지만, Hydrogen의 추론 기본값은 별도로 확인해야 합니다.
  • Antigravity 관리형 에이전트 사용: 모델을 직접 바꾸지 않았어도 기본 설정을 확인할 대상입니다.
  • 실시간 음성·TTS 개발: Hydrogen은 오디오를 입력받을 수 있지만 출력은 텍스트이며, 오디오 생성과 Live API는 지원하지 않습니다. 음성 모델의 대체재로 바로 넣을 수 없습니다. 모델 사양

Flash 전환 시 확인할 다섯 가지

1. 추론 수준을 생략하지 않는다. Hydrogen은 high가 기본값이며 low, medium, high, xhigh를 지원합니다. 기존의 minimal은 오류가 됩니다. 먼저 medium과 high를 비교하고, xhigh는 더 긴 지연과 토큰 사용을 감수할 작업에 한정하는 편이 좋습니다.

2. 입력과 출력의 예산을 다시 계산한다. 입력·추론·출력이 하나의 1,048,576토큰 창을 공유합니다. 동기 응답의 기본 출력 한도는 65,536토큰이고, max_output_tokens에는 추론도 포함됩니다. 입력만 창의 상한에 가깝게 채우면 답변 공간이 부족해집니다.

3. 명시적 캐시 의존을 제거한다. cachedContents, caches.create, 요청의 cached_content를 쓰던 코드는 수정해야 합니다. Hydrogen은 암시적 캐시만 지원합니다.

4. 무시되는 샘플링 값을 정리한다. temperature, top_p, top_k의 사용자 지정 값은 서버가 무시합니다. 예전의 temperature=0 설정만 보고 동일한 출력 특성이 유지된다고 판단하면 안 됩니다.

5. 도구 호출과 대화 상태를 정식 필드로 다룬다. 도구를 선언하지 않고 프롬프트만으로 도구용 JSON 출력을 강제하는 방식은 MALFORMED_FUNCTION_CALL을 일으킬 수 있습니다. 네이티브 도구 선언이나 구조화 출력 스키마를 사용하고, 여러 턴에서는 previous_interaction_id 또는 원래 모델 응답·thought signature를 보존합니다. 공식 마이그레이션 체크리스트

공통 API 래퍼가 이 필드들을 자동으로 붙이는 경우도 있습니다. 호출부뿐 아니라 실제로 전송되는 요청 본문을 점검해야 합니다. 이때 로그에는 키나 원문 데이터를 남기지 말고, 필드 이름과 설정값 위주로 기록하는 것이 안전합니다.

기본값 대신 비교 가능한 설정을 남기자

아래는 Interactions API에서 비교 실험을 시작할 때 쓸 요청 본문 예시입니다. 실제 API를 실행하지는 않았습니다.

이 상한은 매번 65,536토큰을 소비한다는 뜻이 아닙니다. 다만 기존의 낮은 상한을 올리면 요청당 최대 지출 여지도 커집니다. 답변 잘림이 사라지는지와 비용 한도를 함께 확인하고, 출력 길이를 줄이기 위한 제한과 추론 수준 조절을 구분해야 합니다. 공식 가이드는 긴 추론 때문에 답변이 잘리는 낮은 상한을 재검토하도록 안내합니다. 출력 한도 안내

Antigravity의 antigravity-preview-09-2026는 agent_config를 생략하면 이제 Hydrogen을 사용합니다. 운영 기록에 에이전트 ID만 남기면 어떤 모델 조건으로 실행했는지 비교하기 어려워집니다. 모델을 의도적으로 선택하는 경우 agent_config.model을 명시하고, 배포 설정에도 함께 기록하세요. 관리형 에이전트의 모델 선택

단가보다 성공한 작업당 비용을 본다

표준 유료 요금은 100만 토큰당 입력 US$1.50, 출력 US$7.50입니다. 출력 요금에는 추론 토큰이 포함되고, 암시적 캐시 적중 입력은 US$0.075입니다. 도구 사용 비용도 따로 확인해야 합니다. 무료 티어와 유료 티어는 데이터의 제품 개선 사용 여부도 다르므로, 무료라는 이유로 비공개 코드나 고객 자료를 테스트 입력으로 넣지 않도록 주의해야 합니다. 공식 가격표

실무에서는 다음 네 항목을 같은 평가셋으로 비교하는 편이 유용합니다.

  1. 정확성: 수정한 코드의 테스트 통과율, 구조화 출력 검증 실패율.
  1. 지연: 첫 응답 시간과 전체 작업 완료 시간의 p50·p95.
  1. 비용: 재시도·추가 도구 호출까지 포함한 성공 작업 1건당 비용.
  1. 안정성: 긴 입력, 다중 도구 호출, 중단된 작업 재개에서의 실패 유형.

먼저 익명화한 대표 작업으로 기존 모델과 Hydrogen의 medium·high를 비교하고, 통과 기준을 정한 뒤 일부 트래픽에 적용하는 순서가 좋겠습니다. 되돌릴 때는 모델 ID뿐 아니라 캐시·추론·도구 설정도 함께 복구할 수 있게 묶어 두세요.

이번 출시의 실무적인 가치는 선택지가 늘었다는 데 있습니다. 전환 여부는 모델 이름이 아니라 요청 호환성, 지연, 성공 작업당 비용으로 결정하는 것이 안전합니다.

추천 글