제미나이 Decisions API 공개: 가격, 속도, 첫 호출 방법

제미나이 Decisions API는 구글이 2026년 11월 11일(미국 시각) 공개한 새 API로, 글을 써서 답하는 대신 "예/아니오", "여러 보기 중 하나", "0~3점 중 몇 점" 같은 질문에 확률과 확신도로 답한다. 일반 사용자가 직접 켤 기능은 아니다. 고객 문의를 분류하거나 어떤 모델에 일을 보낼지 고르는 앱을 만드는 사람이 쓰는 부품이고, 구글은 발표문에서 이 부품을 제미나이 노트북과 구글 검색 안에서 이미 쓰고 있다고 밝혔다. 가격은 입력 100만 토큰당 $0.10이고 출력은 $0이다.

내가 이 소식에서 할 일이 있나

읽는 사람별 한 줄 결론 (2026년 11월 12일 기준)

나는	결론
챗봇·앱을 쓰기만 하는 사람	할 일이 없다. 발표문 기준으로 제미나이 노트북은 이 API로 일상 질문의 지연을 최대 40% 줄였다
고객 문의·리뷰를 분류하는 마케터, 1인 사업자	AI 스튜디오 놀이터에서 내 문의 몇 건으로 무료로 돌려 본다
지금 챗 모델로 분류·라우팅을 하는 개발자	같은 입력으로 정확도와 비용을 비교해 볼 만하다
구글 클라우드(버텍스)로만 쓰는 팀	아직 기다린다. 구글은 "곧 제공"이라고만 했다

Decisions API는 무엇을 하나: 글 대신 확률로 답한다

보통의 제미나이 호출은 답을 글자 하나씩 이어 써서 만든다. Decisions API는 미리 정해 둔 후보를 한 번의 계산으로 점수 매겨 확률로 돌려준다. 구글은 공식 발표문에서 도구 고르기, 정책 위반 검사, 모델 라우팅(질문을 어떤 모델에 보낼지 정하기), 컨텍스트 평가를 대상 업무로 꼽았다.

질문은 세 종류이고, 공식 API 문서에서 API 이름은 noul(예/아니오), choice, score다. 한 요청에 사진이나 글, 통화 녹음 같은 입력 하나를 넣고 질문을 여러 개 붙일 수 있다.

Decisions API의 질문 종류 (공식 문서 기준)

종류	하는 일	돌려주는 값	조건
noul	예/아니오 판정	예일 확률(0~1)과 확신도	true·false 설명은 선택
choice	보기 중 하나 고르기	고른 보기, 보기별 확률, 확신도	보기 2~255개
score	순서가 있는 채점표로 점수 매기기	가중 평균 점수, 단계별 확률, 확신도	단계 2~255개(2~10개 권장), 0부터 시작

API 문서에 따르면 확신도는 "가장 높게 나온 답이 맞을 확률"의 추정치다. 예/아니오 질문에서는 예일 확률과 1에서 뺀 값 중 큰 쪽과 같다. 발표문도 확신도를 이용해 애매한 건을 대체 처리나 사람 검토로 보내라고 설명한다.

가격과 속도: 입력 $0.10, 출력 $0

구글 발표문의 가격은 입력 100만 토큰당 $0.10, 출력은 $0이다. 토큰은 모델이 글을 처리하는 단위이고 한글 한 글자와 같지 않다. 사고 토큰이나 음성·문자 인식 요금도 따로 붙지 않는다. 같은 입력에 질문 10개를 붙여도 입력은 한 번만 계산한다.

계산 예를 들면 이렇다. 고객 문의 하나가 2,000토큰이고 질문이 10개라면 한 건에 2,000토큰만 센다. 한 달에 문의 10만 건이면 2,000×100,000=2억 토큰이고, 2억÷100만×$0.10=$20이다. 질문을 하나만 붙여도 10개를 붙여도 이 금액은 같다. 다만 질문 문장도 입력 토큰에 들어가므로 질문이 길면 이 계산보다 늘어난다.

발표문이 밝힌 속도는 처음부터 끝까지 150~250ms이고 모델 계산만 보면 중앙값이 50~100ms다. 질문이 1개에서 100개로 늘어도 지연은 거의 그대로라고 한다. 단 이 지연 수치는 컨텍스트 16K 토큰 이하 기준이다.

구글은 발표문에서 공유 벤치마크 묶음 기준으로 Gemini Decision 1과 Decisions API가 Gemini 3.5 Flash-Lite와 Interactions API 조합보다 약 5배 싸다고 밝혔다. 차이는 대부분 출력 토큰이 0원이라는 데서 나온다. 발표문에는 벤치마크 이름과 점수, 비교 금액이 글로 적혀 있지 않아 독자가 이 숫자를 직접 검증할 수는 없다. 정확도가 앞선다는 주장도 구글이 고른 평가에서 나온 것이므로, 내 데이터로 비교해 보는 편이 안전하다.

어디에 쓰이나: 구글이 든 사례와 마케터 활용 후보

발표문이 든 사례는 아래와 같다.

구글이 발표문에서 밝힌 사용처

제품	Decisions API로 하는 일
제미나이 노트북	들어온 질문을 어느 모델 단계와 사고 수준으로 처리할지 고른다. 일상 질문의 지연이 최대 40% 줄었다고 한다
구글 검색	MCP 도구에서 악의적인 동작을 찾아내는 안전 장치로 쓴다
구글 랩스 CC	200개가 넘는 이모지 중 반응 하나를 고른다
스티치(실험 캔버스)	와이어프레임을 만들고 음성·터치 수정을 적용한다

아래는 구글이 든 사례가 아니라 맥피가 API 구조에서 만든 예시다. 문의 메일이 환불, 배송, 제품 문의 중 무엇인지 고르거나(choice), 리뷰가 불만 글인지 판정하거나(noul), 광고 문구가 금지 표현에 얼마나 가까운지 0~3점으로 매기는(score) 일이 맞는 모양이다. 이 API는 정해진 후보 중에서 고르는 일만 하고 글 생성, 요약, 대화에는 쓰지 않는다.

첫 호출 따라 하기: 예/아니오 하나로 시작

API 문서가 소개한 가장 작은 호출이다. 제미나이 API 키는 AI 스튜디오에서 받고, 파이썬 SDK(google-genai) 3.2 이상이 필요하다.

from google import genai

client = genai.Client(http_options={"api_version": "v1beta"})

result = client.decisions.create(
    model="gemini-decision-1",
    input="The blue mug I ordered on Monday arrived cracked on Wednesday.",
    questions={
        "is_damaged": {
            "type": "noul",
            "instructions": "Did the item arrive damaged?",
        },
    },
)

answer = result.answers["is_damaged"]
print(f"P(yes)={answer.noul:.2f} confidence={answer.confidence:.2f}")

성공하면 예일 확률과 확신도가 "P(yes)=0.99 confidence=0.99"처럼 한 줄로 찍힌다(숫자는 문서 응답 예시의 값이고, 실제 값은 입력마다 다르다). 결과 객체의 사용량에서 total_output_tokens가 0인지 보면 출력 요금이 없다는 것도 확인된다. 코드를 쓰지 않고 먼저 보고 싶다면 구글이 만든 AI 스튜디오 놀이터에서 같은 입력을 시험할 수 있다.

선택형은 보기를 criteria에 넣고, 점수형은 낮은 단계부터 순서대로 설명을 적는다. 내 문의 20건쯤을 넣어 보고 사람이 분류한 결과와 어긋나는 건이 몇 개인지 세면 쓸 수 있는지 판단된다.

쓰기 전에 알아 둘 한계

공식 문서의 주의사항 가운데 결과를 틀리게 읽기 쉬운 것만 추렸다.

• 예/아니오 확률은 0.01~0.99 사이로만 나온다. 기준선을 0.99 넘게 잡으면 영원히 걸리지 않는다.
• 선택형은 어떤 보기도 맞지 않아도 확률을 보기들에 나눠 준다. 확신도 기준을 두거나, 별도의 예/아니오 질문으로 범위를 먼저 거르거나, "기타" 보기를 둔다. 보기 키는 알파벳순으로 정렬되고 동점이면 앞의 키가 이기므로 none_of_the_above 같은 위치 의미를 가진 키는 피한다.
• 점수는 확률 가중 평균이라 단계 사이 값(예: 1.12)이 나올 수 있다. 단계별 확률도 함께 본다.
• 질문은 서로 독립적으로 채점되고, 한 질문이 다른 질문 답을 볼 수 없다.
• 유튜브 링크와 gs:// 주소는 입력으로 쓸 수 없고, 컨텍스트 캐싱·배치 API·Flex/Priority 추론도 지원하지 않는다.
• 컨텍스트는 입력과 모든 질문을 합쳐 262,144토큰, 질문은 1,000개까지다. 안전 필터에 걸린 입력은 답 대신 HTTP 400 오류를 받는다.
• 사용자가 쓴 글은 믿지 말아야 한다. 입력 안의 문장이 자기 분류 결과를 바꾸려는 시도를 할 수 있다고 문서가 경고한다.

제미나이 API 쪽의 최근 변경은 요청 저장 기본값 켜짐 글에, 지출 한도 설정은 구글 클라우드 지출 한도 글에 정리했다. 에이전트에 도구를 맡기는 쪽이라면 제미나이 API 컴퓨터 유즈 정식 출시 글도 이어서 볼 만하다.

자주 묻는 질문

무료로 써 볼 수 있나요?

구글은 발표문에서 AI 스튜디오에 시제품용 무료 구간이 있다고 밝혔다. 한도 숫자는 발표문에 없으므로 AI 스튜디오의 요금·한도 화면에서 본다.

버텍스(구글 클라우드)에서도 되나요?

아직 아니다. 발표문은 구글 클라우드의 제미나이 지원을 "곧 제공"이라고 하고 관심 신청 양식을 두었다. 지금은 제미나이 API(v1beta)에서만 된다.

랭체인이나 오픈라우터로도 쓸 수 있나요?

발표문은 오픈라우터, 랭체인, 버셀, 라이트LLM, 파이단틱 AI, 파이프캣, 라이브킷, 오픈코드와의 연동을 순차 제공 중이라고 했다. 어느 도구가 어디까지 지원하는지는 각 도구의 문서에서 확인한다.