본문으로 건너뛰기

Gemini 3.8 Flash API 가이드: 모델 ID, 가격, 사양과 전환

Gemini 3.8 Flash의 공식 모델 ID는 gemini-3.8-flash입니다. 2026년 Standard 요금은 입력 100만 토큰당 0.75달러, 출력 100만 토큰당 3.75달러이며 2027년부터 인상됩니다.

•••3 분 분량•API 가이드
Gemini 3.8 Flash 한국어 API 가이드 표지로 공식 ID, 사양, 지원 도구, 가격, 첫 요청과 2026년 10월 8일부터 3.8 Flash로 자동 전환된 3.7 Flash의 모델 ID 변경을 표시

Google은 2026년 9월 2일 Gemini 3.8 Flash를 정식 버전(GA)으로 출시했습니다. Gemini Developer API의 정확한 모델 ID는 gemini-3.8-flash입니다. Google은 여러 단계에 걸친 소프트웨어 개발, 자율 에이전트, 복잡한 기업 작업을 위한 가장 지능적인 Flash로 설명합니다.

gemini-3.7-flash를 쓰던 시스템은 이미 3.8 Flash로 옮겨진 상태입니다. Google은 2026년 10월 8일 릴리스 노트에서 3.7 Flash를 지원 중단하고 모든 요청을 gemini-3.8-flash로 자동 전환했습니다. 지원이 계속되는 3.6 Flash를 쓰는 시스템이라면 즉시 바꿀 필요는 없습니다. 2026년 말까지 Standard 가격은 3.6과 같고 2027년 1월 1일부터 두 배가 됩니다. 실제 작업의 성공률, 지연, 토큰, 채택 가능한 결과 한 건의 비용으로 전환을 결정하세요.

공식 사양

공식 모델 페이지는 다음 사양을 안내합니다.

항목Gemini 3.8 Flash
모델 IDgemini-3.8-flash
상태안정 버전·정식 출시
입력텍스트, 이미지, 동영상, 오디오, PDF
출력텍스트
입력 한도1,048,576 토큰
출력 한도65,536 토큰
사고 수준low, medium, high
사용 방식Standard, Batch, Flex, Priority

이미지, 동영상, 오디오를 이해할 수 있지만 미디어를 생성하지는 않습니다. 이미지 생성, 음성 생성, Live API는 지원하지 않으므로 해당 출력은 전용 모델을 사용해야 합니다.

도구 지원과 제한

컨텍스트 캐싱, 코드 실행, 파일 검색, 함수 호출, 구조화된 출력, Google 검색·지도 기반 답변, URL 내용 참조와 프리뷰 단계의 컴퓨터 조작을 지원합니다.

구현 전에 세 가지를 확인하세요.

  • minimal 사고 수준은 오류를 반환하며 low, medium, high만 지원합니다.
  • 이미지 생성과 음성 생성은 지원하지 않습니다.
  • Live API는 지원하지 않습니다.

검색 기반 답변, 캐시 저장, 컴퓨터 조작은 이용 조건과 과금 단위가 다르므로 필요한 기능의 요금도 따로 확인하세요.

Gemini 3.8 Flash의 지원 도구, 도구별 조건과 과금, 미지원 기능, 사고 수준 제한과 구현 체크리스트를 보여 주는 한국어 안내도

Gemini 3.8 Flash 가격

Google 가격표는 100만 토큰당 미국 달러 기준이며 출력 가격에는 사고 토큰이 포함됩니다.

방식2026년 입력2026년 출력2027년 입력2027년 출력
Standard$0.75$3.75$1.50$7.50
Batch$0.375$1.875$0.75$3.75
Flex$0.375$1.875$0.75$3.75
Priority$1.35$6.75$2.70$13.50

Standard와 Priority에는 무료 등급이 표시되고 Batch와 Flex에는 없습니다. 캐시와 검색 기반 답변에는 별도 조건이 적용됩니다. 총비용은 입력, 사고를 포함한 출력, 도구와 캐시 등 실제 과금 항목을 합산하고 재시도 요청도 포함해 계산합니다. 비용을 채택 가능한 결과 수로 나누면 결과 한 건을 얻는 데 든 비용을 비교할 수 있습니다. 채택한 결과가 없으면 이 값은 계산하지 않습니다.

첫 API 요청

현재 텍스트 생성 가이드는 Interactions API를 사용합니다.

python
from google import genai

client = genai.Client()
interaction = client.interactions.create(
    model="gemini-3.8-flash",
    input="배포 계획: 새 버전을 요청의 5%에 먼저 적용하고 오류율이 1%를 넘으면 이전 버전으로 되돌립니다. 이 계획에 빠진 실패 조건을 검토해 주세요.",
)
print(interaction.output_text)

REST 요청:

bash
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-3.8-flash","input":"배포 계획: 새 버전을 요청의 5%에 먼저 적용하고 오류율이 1%를 넘으면 이전 버전으로 되돌립니다. 이 계획에 빠진 실패 조건을 검토해 주세요."}'

Python 예제는 Google GenAI SDK가 필요합니다. python -m pip install -U google-genai로 설치하고 실행 환경에 GEMINI_API_KEY를 설정하세요. 코드는 문서 기반 예시이며 실제 호출 시 계정 조건에 따라 과금됩니다. 모델을 비교할 때는 thinking_level, 도구와 시간 제한을 같게 맞춥니다. 사고나 도구 실행 단계가 포함된 응답은 최종 텍스트뿐 아니라 상태와 단계별 결과도 확인하세요.

Gemini 3.8 Flash를 선택할 작업, 실제 비용 계산, 전환 전 평가 지표와 일부 요청으로 시작하는 비교 절차를 정리한 한국어 가이드

Gemini 3.7 Flash에서 바꿔야 할까

이미 바뀌었습니다. 2026년 10월 8일 릴리스 노트에 따르면 gemini-3.7-flash는 지원 중단되었고, 이 ID로 보낸 모든 요청은 gemini-3.8-flash로 자동 전환됩니다. 지원 종료 일정에 3.7 Flash의 종료일은 아직 없지만, 가격표에서는 3.7 Flash 항목이 빠졌습니다. 그래서 지금 정할 것은 전환 여부가 아니라 다음 세 가지입니다.

  • 모델 ID 변경: 코드, 환경 변수, 큐 설정에 남은 gemini-3.7-flash를 gemini-3.8-flash로 바꿉니다. Google도 모델 문자열을 바꾸라고 안내합니다.
  • 기준선 재측정: 3.7 Flash로 측정해 둔 품질과 비용 기준은 더 이상 지금의 응답을 대표하지 않습니다. 일반 요청, 긴 문서, 구조화된 출력, 도구 오류, 안전상 거절과 여러 차례 이어지는 대화를 포함한 고정 작업 묶음으로 첫 시도 성공률, 도구 호출의 정확도, 응답 시간의 중앙값과 95백분위수, 토큰 수, 재시도와 작업별 총비용을 다시 기록하세요.
  • 롤백 대상 변경: 3.7 ID로 되돌려도 3.8 Flash가 응답하므로 3.7로의 롤백은 의미가 없습니다. 문제가 생겼을 때 돌아갈 모델이 필요하다면 지원이 계속되는 gemini-3.6-flash를 같은 작업 묶음으로 평가해 두세요.

Google은 3.8을 GA이자 가장 지능적인 Flash로 소개하지만, 이는 제품 설명이며 자신의 데이터에서 나온 독립 결론은 아닙니다. 전환된 요청에 어느 가격이 적용되는지도 Google은 밝히지 않았습니다. 3.7과 3.8의 2026년 Standard 가격은 같았으므로($0.75 / $3.75) 연말까지는 차이가 없을 가능성이 높지만 확인된 사실은 아니므로, Cloud Billing 보고서에서 SKU별 청구를 확인하세요.

Flash-Lite와 Pro까지 포함한 선택은 별도의 Gemini 텍스트 모델 가이드에서 다룹니다.

결론

gemini-3.8-flash는 지금 호출 가능한 안정형 모델입니다. 장기 소프트웨어 개발, 자율 에이전트, 복잡한 도구 호출, 긴 컨텍스트에서 먼저 평가할 가치가 있습니다. 2027년 가격 인상을 예산에 반영하고 실제 개선이 확인된 작업부터 단계적으로 전환하세요. 코드에 gemini-3.7-flash가 남아 있다면 요청은 이미 3.8 Flash가 처리하고 있으니, 모델 ID를 gemini-3.8-flash로 명시하고 평가 기준선을 다시 잡으세요.

내용에 오류가 있거나 글에서 다루지 않은 문제를 만났다면 글 주소와 상황을 hi@laozhang.ai로 보내 주세요. 확인 후 글을 수정합니다.