최신 Gemini 모델 사용

이 페이지 3.5 Flash

Gemini 3.6 Flash (gemini-3.6-flash) 및 Gemini 3.5 Flash-Lite (gemini-3.5-flash-lite)가 정식 버전 (GA)으로 제공되며 프로덕션에 사용할 수 있습니다.

• Gemini 3.6 Flash: 복잡한 에이전트 및 멀티모달 작업에서 더 강력한 성능을 제공하며, 3.5 Flash보다 낮은 가격으로 토큰 사용량을 줄입니다.
• Gemini 3.5 Flash-Lite: 3.5 제품군에서 가장 빠르고 비용이 저렴한 모델입니다. 처리량이 많은 실행에서 이전 Flash-Lite 세대보다 성능이 뛰어납니다.

이 가이드에서는 각 모델의 새로운 기능, 코드에 영향을 미치는 API 변경사항, 이전 방법을 설명합니다.

새 모델

두 모델 모두 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": {
      "parts": [{"text": "Write a three.js script that renders an interactive 3D robot."}]
    }
  }'

Gemini 3.6 Flash의 새로운 기능

• 토큰 및 턴 감소: Gemini 3.5보다 추론 단계, 대화 턴, 도구 호출이 적은 다단계 워크플로를 완료합니다. 또한 실행 루프가 나선형으로 증가하는 것을 방지합니다.
• 향상된 코드 생성: 원치 않는 수정이 적고 디버깅 루프가 적은 고품질의 프로덕션 준비 코드를 생성합니다.
• 더 나은 안내 준수: 진단 작업 중에 원치 않는 파일 변경을 줄입니다.
• 강력한 멀티모달 및 공간 추론: 차트 해석, 시각적 청사진 변환, 다중 요소 웹 레이아웃 생성의 성능이 개선되었습니다.
• 사전 프로그래매틱 검사: Gemini 3.5 Flash보다 변경하기 전에 진단 코드 스크립트를 더 자주 실행하는 것을 선호합니다. 이렇게 하면 복잡한 작업의 정확성이 향상되지만 간단한 프런트엔드 작업에 추가 탐색 단계가 추가될 수 있습니다.
• Computer Use 지원: 에이전트 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보다 강력한 멀티턴 명령어 팔로우 및 페르소나 일관성
• Computer Use 지원: 에이전트 UI 자동화의 네이티브 도구로 지원됩니다.

올바른 Flash 또는 Flash-Lite 모델 선택

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

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

Antigravity 에이전트 업데이트됨

성능이 개선된 Gemini 3.6 Flash가 이제 Gemini 관리형 에이전트의 Antigravity 에이전트를 지원하는 새로운 기본 모델로 사용됩니다. API에서 새 필드를 설정하여 이를 변경할 수 있습니다.

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    agent="antigravity-preview-05-2026",
    input="Read Hacker News, summarize the top 10 stories, and save the results as a PDF.",
    environment="remote",
)

print(interaction.output_text)

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

const client = new GoogleGenAI({});

const interaction = await client.interactions.create({
    agent: "antigravity-preview-05-2026",
    input: "Read Hacker News, summarize the top 10 stories, and save the results as a PDF.",
    environment: "remote",
}, { timeout: 300000 });

console.log(interaction.output_text);

curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "Content-Type: application/json" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-d '{
    "agent": "antigravity-preview-05-2026",
    "input": "Read Hacker News, summarize the top 10 stories, and save the results as a PDF.",
    "environment": "remote"
}'

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

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

• 샘플링 매개변수 지원 중단: 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.",
)

마이그레이션 체크리스트

gemini-3.6-flash로 마이그레이션

• 모델 ID 업데이트: 타겟 모델 문자열을 gemini-3.6-flash로 변경합니다.
• 지원 중단된 샘플링 매개변수 삭제:
  • 생성 구성에서 temperature, top_p, top_k 삭제
  • thinking_budget을 "medium" 또는 "high"로 설정된 문자열 enum thinking_level로 바꿉니다.
  • candidate_count 삭제 (Gemini 3.x에서 지원되지 않음)
• 턴 유효성 검사 규칙 적용:
  • 서버 측 previous_interaction_id에서 멀티턴 대화를 표준화합니다.
  • 사전 입력된 모델 턴을 삭제합니다.
• 함수 호출 감사:
  • 멀티모달 애셋을 응답 페이로드 내에 배치합니다.
  • \n\n을 사용하여 인라인 안내의 형식을 지정합니다.
  • 사전 도구 텍스트와 관련된 Malformed_Function_Call 오류가 표시되면 사전 도구 텍스트 요구사항 해결 방법을 참고하세요.
  • generateContent API를 사용하는 경우에만: 모든 FunctionResponse 객체에 call_id 및 name가 포함되어야 합니다.
• 기준 Gemini 3.x 요구사항: SDK 업데이트 및 생각 서명 보존은 Gemini 3.5 이전 체크리스트를 참고하세요.

gemini-3.5-flash-lite로 마이그레이션

• 모델 ID 업데이트: 타겟 모델 문자열을 gemini-3.5-flash-lite로 변경합니다.
• 사고 노력 수준 구성:
  • 대량 추출, 라우팅 또는 분류의 경우 최대 처리량을 위해 thinking_level을 "minimal" (기본값)으로 유지합니다.
  • 도구 호출, 코드 실행 또는 다단계 추론이 있는 자율 하위 에이전트의 경우 thinking_level을 "medium" 또는 "high"로 설정하여 도구가 조기에 종료되지 않도록 합니다.
• 지원 중단된 매개변수 삭제 및 함수 호출 검증: 3.6 Flash와 동일한 규칙을 적용합니다.
• 기준 Gemini 3.x 요구사항: Gemini 3.5 마이그레이션 체크리스트를 참고하세요.

다음 단계

• 모델 개요에서 API 사양을 검토하세요.
• Interactions API 가이드에서 멀티 에이전트 조정을 살펴보세요.
• Google AI Studio에서 프롬프트를 테스트하고 개선합니다.