저널 Uncategorized

Genie 4 API 정리: Gemini API에서 쓰는 조건, 초당 요금·사용 한도와 세션 제약

개발자가 와이드 모니터 속 동화풍 언덕과 강 풍경을 키보드로 탐색하고, 옆에 스톱워치·동전·음파 아이콘이 떠 있는 AI 생성 설명용 일러스트
AI로 생성한 설명용 일러스트이며 실제 사건의 사진이 아닙니다.

글이나 그림 한 장을 넣으면 그 안을 걸어 다닐 수 있는 장면이 만들어지는 ‘AI 월드 모델’은 지금까지 주로 연구 영상으로만 볼 수 있었습니다. 이번에는 개발자가 API로 직접 호출할 수 있는 형태로 공개됐습니다.

구글은 2026년 11월 19일(미국 기준) Genie 4를 Gemini API와 Google AI Studio에 공개했습니다. 하루 전에는 Google AI Ultra 구독자용 Project Genie에 먼저 들어갔습니다. 다만 API는 초 단위로 요금이 쌓이고, 세션 길이와 동시 접속 수에도 제한이 있습니다. 이 글에서는 공식 문서를 기준으로 무엇을 할 수 있는지, 비용은 어떻게 계산되는지, 쓰기 전에 무엇을 확인해야 하는지를 정리했습니다.

1. Genie 4 API로 무엇이 공개됐나

구글 공식 블로그 발표와 Gemini API 릴리스 노트를 보면 Genie 4(genie-4)는 v1beta Interactions API에서 정식 버전(GA)으로 제공됩니다. 실시간으로 반응하는 영상 세계를 스트리밍하는 모델입니다.

  • 출력: 1280×720(720p), 16:9, 초당 24프레임 영상과 48kHz 스테레오 오디오
  • 시작 입력: 텍스트 프롬프트, 16:9 참조 이미지 1장, 또는 둘 다
  • 조작: WASD로 이동하고 방향키로 시점을 돌립니다. 세션 중에 텍스트를 보내 날씨·조명·사물·사건을 바꾸거나 캐릭터 대사를 넣을 수 있습니다.
  • 워터마크: 구글은 모든 출력에 눈에 보이지 않는 SynthID 워터마크가 들어간다고 밝혔습니다.

구글이 제시한 활용 예시는 인터랙티브 체험 프로토타입, 공간 설계 시각화, 로봇·AI 에이전트 학습입니다. 정해진 길이의 영상 클립을 만드는 모델이 아니라, 사용자의 입력에 맞춰 장면을 계속 이어 그리는 모델이라는 점이 핵심입니다.

2. 요금: 초당 약 0.10달러, 무료 등급 없음

공식 요금 페이지에 따르면 Genie 4는 유료 등급 API 키에서만 쓸 수 있습니다. 무료 등급에서는 쓸 수 없습니다.

  • 입력(텍스트·참조 이미지): 100만 토큰당 1.50달러
  • 텍스트 출력: 100만 토큰당 9.00달러
  • 영상 출력(오디오 포함): 100만 토큰당 17.50달러
  • 컨텍스트 캐싱: 지원하지 않음

영상은 프레임당 240토큰, 초당 5,760토큰으로 계산됩니다. 공식 문서는 이를 초당 약 0.10달러, 분당 약 6.05달러로 환산해 안내합니다. 이 기준으로 직접 계산하면 최대 길이인 120초 세션 1회는 영상 출력만 약 12.1달러입니다. 입력 토큰은 별도이고, 원화 금액은 환율과 세금에 따라 달라집니다.

절반 가격의 Batch API, Flex 추론, Priority 추론도 지원하지 않습니다. 다른 Gemini 모델처럼 비동기 처리로 비용을 낮추는 방법은 아직 없습니다.

3. 사용 등급별 동시 세션과 하루 요청 한도

Gemini API 사용량 한도 문서에는 Genie 4 전용 한도가 따로 있습니다. 한도는 API 키가 아니라 프로젝트 단위로 적용됩니다.

  • Tier 1: 동시 활성 세션 2개, 하루 요청 50회
  • Tier 2: 동시 세션 5개, 하루 250회
  • Tier 3: 동시 세션 10개, 하루 1,000회

세션 안에서 보내는 키보드 조작(user_action)과 텍스트 이벤트(input)는 분당·일일 요청 한도를 따로 차감하지 않습니다. 일일 한도는 미국 태평양 시간 자정에 초기화됩니다.

같은 문서에는 10분 단위의 지출 기반 한도도 있습니다. Tier 1은 10분에 10달러이며, 결제 이력에 따라 적용되지 않을 수도 있다고 적혀 있습니다. 이 한도가 적용되는 Tier 1 프로젝트라면, 공식 환산 단가로 직접 계산했을 때 10분 동안 영상 약 100초 정도에서 한도에 닿을 수 있습니다. 한도를 넘으면 429 오류가 납니다. 여러 세션을 이어서 테스트할 계획이라면 AI Studio의 한도 화면에서 실제 값을 먼저 확인하는 것이 좋습니다.

4. 세션 흐름과 과금을 확실히 끝내는 방법

Genie 4 개발 가이드는 세션을 네 단계로 설명합니다.

  1. 서버에서 model을 genie-4로 지정해 인터랙션을 만듭니다. 브라우저용으로는 이 세션 하나에만 쓰는 임시 토큰을 발급합니다.
  2. WebRTC(브라우저 앱 권장) 또는 WebSocket(Python·Node.js, 프레임 캡처용)으로 연결합니다.
  3. world_setup 이벤트를 한 번 보내 세계를 만든 뒤 키 입력과 텍스트로 조종합니다.
  4. 끝나면 complete()를 호출해 생성과 과금을 멈춥니다.

가장 주의할 부분은 4단계입니다. 가이드에 따르면 브라우저 탭을 닫거나 연결만 끊어서는(detach) 서버 쪽 생성이 바로 멈추지 않습니다. 반드시 complete() 또는 cancel()을 호출해야 하고, 끝난 세션은 다시 이어갈 수 없습니다. 초 단위로 과금되는 모델이므로 오류 처리 코드에도 종료 호출을 넣어 두는 편이 안전합니다.

보안 면에서는 장기 API 키를 브라우저 코드에 넣지 말고, 백엔드에서 발급한 임시 토큰을 넘기라고 안내합니다. 첫 프레임이 나오기까지는 약 5~9초가 걸린다고 적혀 있습니다.

5. Project Genie 구독, 다른 Gemini 모델과의 차이

같은 Genie 4라도 쓰는 경로가 두 가지입니다. 11월 18일 Project Genie 발표에 따르면 일반 사용자용 Project Genie는 자격을 갖춘 Google AI Ultra 구독자에게 제공되고, Google AI Pro 회원은 대기 명단에 등록할 수 있습니다. Project Genie에는 대화로 세계를 만드는 에이전트와 커뮤니티 갤러리가 있고, 세션 길이를 3분까지 늘린 Genie 3도 함께 선택할 수 있습니다.

반면 API는 구독이 아니라 결제 계정이 연결된 프로젝트의 사용량으로 요금을 냅니다. 사용량 한도 문서 기준으로 Tier 1은 활성 결제 계정을 연결하면 바로 해당됩니다.

구글 문서는 목적에 따라 다른 모델을 권합니다.

  • 실시간으로 조종하는 세계·플레이 가능한 시각 프로토타입: Genie 4
  • 3~15초 영상 클립 생성, 영상 편집·연장, 고해상도 업스케일: Gemini Omni 1.2 Flash
  • 마이크·카메라를 쓰는 실시간 음성 에이전트, 도구 호출: Gemini 3.8 Live

6. 쓰기 전에 확인할 한계와 주의점

Genie 4 모델 페이지와 개발 가이드에 적힌 제약은 다음과 같습니다.

  • 세션 길이: 최대 120초입니다. 화면 일관성과 사물 유지는 처음 45~90초가 가장 좋고, 60~90초가 지나면 안정성이 떨어질 수 있습니다.
  • 장면 기억: 고정된 3D 장면을 저장하지 않습니다. 한 물체에서 8초 이상 눈을 돌리거나 한 바퀴 돌면 건물·문·버튼 위치가 바뀔 수 있습니다. 로봇·에이전트 실험에서 안정적인 지도로 가정하기 어렵습니다.
  • 반응 속도: 키 입력은 약 0.2~0.5초, 텍스트로 바꾸는 장면 변화는 약 1~2초 뒤에 반영됩니다.
  • 화면 형식: 16:9 가로 화면만 지원하며, 세로 화면이나 프레임 속도 변경은 지원하지 않습니다.
  • 지원하지 않는 기능: 실시간 마이크·웹캠 입력, 함수 호출, 구글 검색 그라운딩, 구조화된 출력, 종료된 세션 재개
  • 콘텐츠 필터: 실존 인물·유명인이나 저작권이 있는 브랜드 IP가 들어간 프롬프트·이미지는 시작 단계에서 막히거나 진행 중에 세션이 끊길 수 있습니다.
  • 세부 표현: 간판·계기판·시계의 글자는 시간이 지나면서 일그러지고, 정확한 물체 개수도 시점을 바꾸면 달라질 수 있습니다.

한국에서 쓸 때는 지연 시간도 확인해야 합니다. 공식 문서는 서비스 지역을 미국·서유럽·일본으로 적고, 동아시아를 포함한 일부 지역에서 왕복 150ms 미만의 응답을 기대할 수 있다고 안내합니다. 실제 지연은 네트워크 환경마다 다르므로 배포 전에 대상 지역에서 직접 측정하라고 권합니다. 참고로 Unite.AI 보도는 서비스 지역을 미국으로만 적었는데, 이 글은 공식 모델 문서를 기준으로 했습니다.

정리

Genie 4 API는 텍스트나 이미지 한 장으로 걸어 다닐 수 있는 장면을 만들고 코드로 조종하게 해 줍니다. 다만 유료 등급 전용이고 초당 약 0.10달러가 계속 과금되며, 세션은 최대 2분이고 장면 기억이 짧습니다. 따라서 긴 게임 세계보다는 짧은 체험 데모나 공간 아이디어 시각화에 맞습니다.

  • 내 프로젝트의 사용 등급과 지출 기반 한도가 적용되는지 확인하기
  • 종료·오류 처리 코드에 complete() 또는 cancel() 넣기
  • 브라우저에는 임시 토큰만 넘기기
  • 한국에서의 실제 지연 시간을 먼저 측정하기

요금과 한도는 바뀔 수 있으니 실제로 쓰기 전에 공식 요금·한도 페이지를 다시 확인하세요.

출처

자료 확인일: 2026년 11월 21일(한국 시간)

AI로 생성한 설명용 일러스트이며 실제 사건의 사진이 아닙니다.