지니 4 API 개방…가상세계 영상 출력 초당 약 0.10달러
편집·검토: AI Ping 편집팀
3줄 요약
- 개발자가 실시간으로 조작하는 가상세계를 앱에 연결한다.
- 영상은 음성 포함 초당 약 0.10달러이며 한 세션은 최대 120초다.
- 연결 해제와 생성 종료가 달라 종료 처리와 사용량 한도를 따로 관리해야 한다.
구글이 11월 19일 지니 4를 제미나이 API와 구글 AI 스튜디오에 공개했다. 개발자가 텍스트나 참고 이미지로 가상세계를 만들고, 키보드와 문장으로 탐험 중인 장면을 바꾸는 기능을 앱에 연결할 수 있게 됐다. 전날 개인 이용자용 프로젝트 지니에 이어 개발자용 접근 경로를 연 것이다.
이용 비용은 유료 API 사용량에 따라 계산한다. 입력 텍스트·참고 이미지는 100만 토큰당 1.50달러, 텍스트 출력은 9달러다. 영상 출력은 음성을 포함해 100만 토큰당 17.50달러이며, 24fps 기준 초당 약 0.10달러, 1분당 약 6.05달러에 해당한다. 입력과 텍스트 출력 비용은 별도로 더해진다.
한 세션은 최대 120초다. 모델 안내에는 1280×720 해상도, 16대9 화면 비율과 초당 24프레임 영상, 48kHz 스테레오 음성이 명시돼 있다. 처음 세계를 설정할 때 참고 이미지 한 장을 넣을 수 있다. 실시간 브라우저 전송에서는 참고 이미지를 48KB 미만의 압축 JPEG로 준비하도록 안내한다. 전송되는 이미지 포함 메시지 크기가 연결의 제한을 넘지 않게 하기 위한 조건이다.
생성 영상에는 주변 소리와 등장인물의 대화가 붙는다. 구글은 모든 출력에 눈에 보이지 않는 신스ID 워터마크를 넣는다고 밝혔다.
브라우저를 닫아도 생성은 이어질 수 있다
개발 문서는 서버가 상호작용 세션을 만들고, 브라우저는 그 세션에만 쓰는 임시 인증값으로 접속하는 구성을 설명한다. 장기 API 키는 서버에 둔다. 브라우저의 실시간 연결과 파이썬·자바스크립트 처리 경로를 제공하며, 연결 뒤 초기 세계를 설정하고 이동·문장 명령을 보낸다.
과금 종료는 연결을 끊는 동작과 다르다. 구글은 브라우저 탭을 닫거나 로컬 연결을 해제해도 서버의 생성이 즉시 멈추지 않는다고 설명했다. 세션 완료 호출은 생성과 토큰 과금을 끝내고, 취소 호출은 생성을 즉시 중단한다. 잠시 연결을 떼는 기능은 다시 접속할 때를 위한 것으로 안내한다.
가상세계의 물체가 계속 같은 자리에 남는 데는 한계가 있다. 조작 안내는 최근 화면을 바탕으로 상태를 유지한다며, 8초 넘게 보지 않은 물체나 건물이 다시 돌아봤을 때 달라질 수 있다고 밝혔다. 60~90초를 지나면 화면의 일관성도 떨어질 수 있다. 문서가 제시하는 적합한 장면은 짧은 이동 경로나 한 물체를 계속 바라보는 상호작용이다.
이동 키의 화면 반응은 낮은 네트워크 지연에서 약 0.2~0.5초, 문장으로 환경을 바꾸는 반응은 약 1~2초로 안내돼 있다. 안내 문서는 일부 키의 이름만으로 점프나 물체 조작이 구현되는 것은 아니라며, 해당 행동을 문장 입력으로 연결하는 방식을 설명한다.
동시에 열 수 있는 세션과 하루 요청 수도 정해져 있다. 유료 사용 등급 1은 동시 2개·하루 50회, 등급 2는 5개·250회, 등급 3은 10개·1000회다. 세션 안에서 보내는 이동·문장 제어 메시지는 분당·하루 요청 할당량을 따로 소모하지 않는다.
할당량은 프로젝트 단위로 적용한다. 같은 프로젝트의 키를 여러 개 쓰더라도 한도를 나눠 늘리는 방식이 되지 않는다. 일반 호출 한도 안내는 하루 요청 수가 태평양 시간 자정에 초기화된다고 설명하며, 실제 적용 한도는 AI 스튜디오에서 확인하도록 안내한다. 지니 4는 무료 등급과 배치 처리·플렉스·우선 처리를 지원하지 않는다.
서비스는 현재 미국 데이터센터에서 제공한다. 구글은 왕복 네트워크 지연이 150밀리초를 넘으면 실시간 키보드 조작이 느려진다고 명시했다. 이는 서버 위치와 조작 지연에 관한 조건이다. 모델의 화면 비율·해상도·프레임 수는 정해져 있어 세로 화면이나 다른 지역 전용 접속 지점을 선택할 수 없다.
유료 서비스의 입력 자료와 생성 결과에는 API 약관의 데이터 처리 기준을 적용한다. 구글은 프롬프트와 파일·응답을 제품 개선에 사용하지 않는다고 명시했다. 다만 금지된 이용의 탐지·예방과 법령상 공개 의무를 위해 입력·응답을 제한된 기간 기록한다. 계정 정보·결제 이력·사용량과 기술 오류 같은 운영 데이터는 별도의 개인정보 처리 기준을 따른다. 약관은 유료 API를 활성 결제 계정에 연결된 클라우드 프로젝트를 통해 쓰는 경우로 정의한다. 이 안전성 관련 기록은 구글이나 대리인이 시설을 둔 국가에 일시 저장되거나 캐시될 수 있다고 명시돼 있다.
출처
- Genie 4 is now available on the Gemini API — November 19, 2026 — Google
- Gemini API pricing — Genie 4 — Google AI Studio
- Genie 4 model specification — Google AI Studio
- Interactive world generation with Genie 4 — Google AI Studio
- Genie 4 prompt and controls guide — Google AI Studio
- Gemini API rate limits — Genie 4 — Google AI Studio
- Gemini API Additional Terms of Service — Paid Services — Google AI Studio
정정 내역
- 운영 이미지 변환에서 요금 도식 글자가 표시되지 않아 같은 도식을 PNG로 교체했습니다. 본문 내용·최초 발행 시각·대표 그림은 유지했습니다.