Gemini 3.6 Flash 및 3.5 Flash-Lite의 새로운 기능

새 모델

두 모델 모두 100만 토큰 컨텍스트 윈도우, 최대 64,000개의 출력 토큰, 사고 모델, 컴퓨터 사용을 비롯한 전체 기본 제공 도구 모음을 지원합니다.

전체 사양은 모델 페이지를 참고하세요.

• Gemini 3.6 Flash 모델 페이지
• Gemini 3.5 Flash-Lite 모델 페이지

자세한 가격 책정은 가격 책정 페이지를 참고하세요.

빠른 시작

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.6-flash",
    input="Write a three.js script that renders an interactive 3D robot."
)

print(interaction.output_text)

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({});

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3.6-flash",
    input: "Write a three.js script that renders an interactive 3D robot.",
  });
  console.log(interaction.outputText);
}

main();

curl "https://generativelanguage.googleapis.com/v1beta/interactions"       -H "x-goog-api-key: $GEMINI_API_KEY"       -H 'Content-Type: application/json'       -X POST       -d '{
    "model": "gemini-3.6-flash",
    "input": "Write a three.js script that renders an interactive 3D robot."
  }'

Gemini 3.6 Flash의 새로운 기능

• 토큰 및 턴 감소: Gemini 3.5보다 더 적은 추론 단계, 대화 턴, 도구 호출로 여러 단계로 이루어진 워크플로를 완료합니다. 또한 실행 루프가 나선형으로 증가하는 것을 줄여줍니다.
• 향상된 코드 생성: 원치 않는 수정사항과 디버깅 루프가 더 적은 고품질의 프로덕션 레디 코드를 생성합니다.
• 향상된 안내 따르기: 진단 작업 중에 원치 않는 파일 변경사항을 줄입니다.
• 강력한 멀티모달 및 공간 추론: 차트 해석, 시각적 청사진 변환, 여러 요소 웹 레이아웃 생성에서 성능이 향상되었습니다.
• 사전 프로그래매틱 검사: Gemini 3.5 Flash보다 변경하기 전에 진단 코드 스크립트를 실행하는 것을 더 선호합니다. 이렇게 하면 복잡한 작업의 정확성이 향상되지만 일상적인 프런트엔드 작업에 추가 탐색 단계가 추가될 수 있습니다.
• 컴퓨터 사용 지원: 에이전트형 UI 자동화를 위한 기본 제공 도구로 지원됩니다.
• UI 스타일 지정 환경설정: 기능 코드를 더 잘 만들 수 있지만, 시각적 레이아웃 및 스타일 지정에는 인간 평가자가 이전 모델을 선호했습니다. 명시적인 디자인 가이드라인을 제공하여 이 문제를 완화할 수 있습니다.
• 기본 사고 노력 (중간): Gemini 3.5 Flash와 동일한 medium 기본 사고 수준을 사용합니다.
• 가격 인하: 출력 토큰 비용이 낮아졌습니다 (3.5 Flash의 경우 100만 개당 $9.00에서 100만 개당 $7.50으로). 입력 토큰은 100만 개당 $1.50으로 유지됩니다.

Gemini 3.5 Flash-Lite의 새로운 기능

• 작업 실행 지연 시간 감소: 대용량 데이터 파싱 및 문서 추출을 위한 3.5 제품군에서 가장 높은 처리량을 제공합니다.
• 향상된 추론 및 멀티모달 성능: HLE (18.0% 대 11.0%)와 같은 추론 작업과 CharXIV (74.5% 대 63.7%)와 같은 멀티모달 벤치마크에서 더 높은 점수를 기록하여 Gemini 2.5 Flash에서 강력한 마이그레이션 경로를 제공합니다.
• 하위 에이전트 조정 및 도구 안정성: 코드 실행, 검색, MCP 워크플로의 도구 실행 안정성을 개선합니다. 자율 계획 및 복잡한 하위 에이전트 작업의 사고 수준을 높입니다.
• 향상된 문서 이해: 문서 파싱 및 구조화된 데이터 추출의 정확성을 개선합니다. 문서 복잡성에 따라 최소 및 높은 사고 수준을 모두 실험해 보세요.
• 대화형 웹 코딩 및 테이블 형식 데이터 처리: 경량 코드 실행을 사용하여 계획함으로써 프런트엔드 JavaScript 및 테이블 형식 데이터 처리에서 강력한 성능을 발휘합니다.
• 챗봇 및 페르소나 지속성: Gemini 3.1 Flash-Lite보다 더 강력한 다중 턴 안내 따르기 및 페르소나 일관성을 제공합니다.
• 컴퓨터 사용 지원: 에이전트형 UI 자동화를 위한 기본 제공 도구로 지원됩니다.

적절한 Flash 또는 Flash-Lite 모델 선택

이 표를 사용하여 워크로드에 적합한 모델과 마이그레이션 경로를 선택하세요.

두 모델 모두 지원 중단된 샘플링 매개변수 (temperature, top_p, top_k)와 사전 입력된 모델 턴을 삭제해야 합니다. 자세한 내용은 API 변경사항을 참고하세요.

Antigravity 에이전트 지원

Gemini 3.6 Flash는 Gemini 관리형 에이전트에서 Antigravity 에이전트 지원을 도입했습니다.

현재 코드 샘플과 최신 기본 에이전트 구성은 Antigravity 에이전트 가이드 및 Gemini 3.8 Flash 가이드를 참고하세요.

API 변경사항 및 파라미터 업데이트

Gemini 3.6 Flash 및 Gemini 3.5 Flash-Lite부터 다음 API 변경사항이 이러한 모델과 향후 모든 Gemini 모델 출시 버전에 적용됩니다.

• 샘플링 매개변수 지원 중단: temperature, top_p, top_k가 지원 중단됩니다. API는 이러한 매개변수를 무시하고 향후 모델 생성에서 오류를 반환합니다.
• 사전 입력된 모델 턴 검증: 사전 입력된 모델 턴은 더 이상 지원되지 않습니다. 요청의 마지막으로 비어 있지 않은 턴이 model 턴인 경우 API는 400 오류를 반환합니다.

다음 섹션에서는 각 API 변경사항에 대한 자세한 설명과 코드 샘플을 제공합니다.

1. 샘플링 매개변수 지원 중단 (temperature, top_p, top_k)

temperature, top_p, top_k가 지원 중단되고 무시됩니다. 향후 모델 생성에서 이러한 매개변수를 제공하면 HTTP 400 오류가 반환됩니다. 모든 요청에서 이러한 매개변수를 삭제합니다.

# ⚠️ Remove these parameters (deprecated)
generation_config = {
     "temperature": 0.7,
     "top_p": 0.9,
     "top_k": 40,
}

결정성을 개선하려면 특정 사용 사례에 대한 명시적 규칙으로 시스템 안내를 정의하세요.

2. 사전 입력된 모델 턴 검증

비어 있지 않은 모델 역할 턴으로 끝나는 API 요청은 허용되지 않으며 HTTP 400 오류 를 반환합니다.

⚠️ 제외

이전 generateContent 또는 원시 REST 페이로드에서 모델 역할 턴으로 끝나는 것은 이제 허용되지 않습니다.

/* ❌ DO NOT: End payload contents with a 'model' role turn */
{
  "contents": [
    {"role": "user", "parts": [{"text": "Translate 'Hello world' to Spanish."}]},
    {"role": "model", "parts": [{"text": "Translation:"}]}  /* ❌ Returns error */
  ]
}

✅ 권장되는 마이그레이션 (Interactions API)

Interactions API에서는 모델 턴이 수동으로 사전 입력되지 않습니다. 이전에 애플리케이션에서 모델 턴을 사전 입력하여 서문을 억제하거나 JSON 형식을 강제 적용한 경우 system_instruction 또는 구조화된 출력을 대신 사용하세요.

# ✅ RECOMMENDED: Use system_instruction in the Interactions API to specify output format
interaction = client.interactions.create(
    model="gemini-3.6-flash",
    input="Translate 'Hello world' to Spanish.",
    system_instruction="Output only the translation without introductory text.",
)

마이그레이션 체크리스트