이제 Interactions API가 정식 버전으로 출시되었습니다. 이 API를 사용하여 모든 최신 기능과 모델에 액세스하는 것이 좋습니다.

Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

Gemini 3.8 Flash의 새로운 기능

Gemini 3.8 Flash (gemini-3.8-flash)는 정식 버전 (GA)으로 출시되어 프로덕션에 사용할 수 있습니다. 장기적인 소프트웨어 엔지니어링, 자율 에이전트, 복잡한 엔터프라이즈 워크플로를 위해 설계된 가장 지능적인 Flash 모델입니다.

이 가이드에서는 Gemini 3.8 Flash의 새로운 기능, API 변경사항, 코드 샘플, 마이그레이션 안내를 설명합니다.

새 모델

모델	모델 ID	기본 사고 수준	가격 책정	설명
Gemini 3.8 Flash	`gemini-3.8-flash`	`medium`	3.8 Flash는 연말까지 입력 토큰 100만 개당 $0.75, 출력 토큰 100만 개당 $3.75의 신규 할인 가격으로 제공됩니다. 자세한 내용은 가격 책정을 참고하세요.	장기적인 소프트웨어 엔지니어링, 자율 에이전트, 복잡한 엔터프라이즈 워크플로를 위해 설계된 가장 지능적인 Flash 모델입니다.

Gemini 3.8 Flash는 100만 개의 토큰 컨텍스트 윈도우, 최대 64,000개의 출력 토큰, 조정 가능한 사고 수준 (low, medium, high), 동일한 포괄적인 기본 제공 도구 모음을 지원합니다.

전체 사양은 Gemini 3.8 Flash 모델 페이지를 참고하세요. 특별 가격에 대한 자세한 내용은 아래의 가격 책정 섹션 또는 가격 책정 페이지를 참고하세요.

빠른 시작

Python

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.8-flash",
    input="Write a three.js script that renders a realistic 3D black hole."
)

print(interaction.output_text)

JavaScript

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

const client = new GoogleGenAI({});

const interaction = await client.interactions.create({
  model: "gemini-3.8-flash",
  input: "Write a three.js script that renders a realistic 3D black hole.",
});

console.log(interaction.output_text);

자바

import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.CreateModelInteraction;
import com.google.genai.gaos.models.interactions.Interaction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.interactions.Model;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;

Client client = new Client();
CreateModelInteraction req = CreateModelInteraction.builder()
    .model(Model.of("gemini-3.8-flash"))
    .input(InteractionsInput.of("Hello world"))
    .build();
Interaction interaction =
    client.interactions.create(CreateInteractionRequestBody.of(req)).interaction().get();
System.out.println(interaction.outputText().orElse(""));

REST

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.8-flash",
    "input": "Write a three.js script that renders a realistic 3D black hole."
  }'

Gemini 3.8 Flash의 새로운 기능

장기적인 소프트웨어 엔지니어링: 실제 코딩 벤치마크, 복잡한 다중 파일 리팩터링, 결정적 도구 실행에서 강력한 결과를 제공합니다. 자세한 내용은 평가 방법론을 참고하세요.
자율 에이전트: 복원력이 뛰어난 다단계 계획 및 도구 조정 워크플로를 빌드하여 실패한 루프와 오류를 크게 줄일 수 있습니다.
복잡한 엔터프라이즈 워크플로: 까다로운 도메인 작업과 대규모 데이터 파이프라인에서 뛰어난 정확성, 심층적인 추론, 높은 사실적 엄격성을 제공합니다.
관리형 에이전트의 기본 모델: 관리형 에이전트의 기본 에이전트인 Antigravity 에이전트가 이제 Gemini 3.8 Flash를 사용합니다. Antigravity SDK도 기본적으로 Gemini 3.8 Flash를 사용합니다.
특별 가격: Gemini 3.8 Flash는 2026년 12월 31일까지 입력 토큰 100만 개당 $0.75, 출력 토큰 100만 개당 $3.75의 특별 가격으로 제공됩니다. 입력 토큰 100만 개당 $1.50, 출력 토큰 100만 개당 $7.50의 표준 가격은 2027년 1월 1일부터 적용됩니다.

Gemini 3.8 Flash는 설계상 더 오래 실행되고 복잡한 작업에서 더 많은 토큰을 사용할 수 있습니다. 어려운 다단계 목표에서 더 높은 품질의 결과를 제공하기 위해 모델은 더 작은 추론 단계를 거치고, 도구를 반복적으로 호출하며, 진행하면서 작업을 확인합니다. 모든 워크플로에 이 수준의 확인이 필요한 것은 아닙니다. 일상적인 작업의 경우 추론 노력을 줄여 토큰 소비를 줄일 수 있습니다. 또는 Gemini 3.7 Flash는 계속해서 완벽히 지원됩니다.

추론 수준 이해

Gemini 3.8 Flash를 사용하면 모델의 사고 수준을 조정하여 지연 시간과 인텔리전스를 유연하게 제어할 수 있습니다.

낮은 사고 노력: 인시던트 대응 파이프라인, 실시간 채팅, 초안 작성, 빠른 데이터 분석과 같은 지연 시간에 민감한 작업의 답변 시간을 줄입니다.
중간 (기본값): 대부분의 작업에 가장 적합한 품질입니다. 복잡한 코드 및 에이전트 사용 사례에 권장되며, 더 높은 첫 번째 패스 정확도를 제공합니다.
높은 사고 노력: 모델의 추론 및 도구 조정 기능을 극대화합니다. 심층 추론, 수학, 어려운 다단계 작업에 가장 적합합니다.

다음 예시에서는 복잡한 코드 분석 요청에 대해 thinking_level을 medium으로 설정합니다.

Python

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.8-flash",
    input="Analyze this payment processing pipeline for race conditions during retry attempts and rewrite the transaction locks safely.",
    generation_config={
        "thinking_level": "medium"  # Balanced reasoning effort for complex tasks
    }
)

print(interaction.output_text)

JavaScript

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

const client = new GoogleGenAI({});

const interaction = await client.interactions.create({
  model: "gemini-3.8-flash",
  input: "Analyze this payment processing pipeline for race conditions during retry attempts and rewrite the transaction locks safely.",
  generation_config: {
    thinking_level: "medium"
  }
});

console.log(interaction.output_text);

자바

import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.CreateModelInteraction;
import com.google.genai.gaos.models.interactions.Interaction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.interactions.Model;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;

Client client = new Client();
CreateModelInteraction req = CreateModelInteraction.builder()
    .model(Model.of("gemini-3.8-flash"))
    .input(InteractionsInput.of("Hello world"))
    .build();
Interaction interaction =
    client.interactions.create(CreateInteractionRequestBody.of(req)).interaction().get();
System.out.println(interaction.outputText().orElse(""));

REST

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.8-flash",
    "input": "Analyze this payment processing pipeline for race conditions during retry attempts and rewrite the transaction locks safely.",
    "generation_config": {
      "thinking_level": "medium"
    }
  }'

업데이트된 Antigravity 에이전트

Gemini Managed Agents의 Antigravity 에이전트는 성능과 추론이 개선되어 이제 기본적으로 Gemini 3.8 Flash로 빌드됩니다.

Python

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    agent="antigravity-preview-05-2026",
    input=(
        "Audit https://web.dev for performance, Core Web Vitals, and SEO. "
        "Query Google's PageSpeed Insights API for both Mobile and Desktop strategies. "
        "Check search indexing with Google Search for site:web.dev. "
        "Format the output as a side-by-side scorecard table with prioritized fixes."
    ),
    environment="remote",
)

print(interaction.output_text)

JavaScript

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

const client = new GoogleGenAI({});

const interaction = await client.interactions.create({
  agent: "antigravity-preview-05-2026",
  input: "Audit https://web.dev for performance, Core Web Vitals, and SEO. Query Google's PageSpeed Insights API for both Mobile and Desktop strategies. Check search indexing with Google Search for site:web.dev. Format the output as a side-by-side scorecard table with prioritized fixes.",
  environment: "remote",
}, { timeout: 300000 });

console.log(interaction.output_text);

자바

import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.CreateModelInteraction;
import com.google.genai.gaos.models.interactions.Interaction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.interactions.Model;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;

Client client = new Client();
CreateModelInteraction req = CreateModelInteraction.builder()
    .model(Model.of("gemini-3.8-flash"))
    .input(InteractionsInput.of("Hello world"))
    .build();
Interaction interaction =
    client.interactions.create(CreateInteractionRequestBody.of(req)).interaction().get();
System.out.println(interaction.outputText().orElse(""));

REST

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": "Audit https://web.dev for performance, Core Web Vitals, and SEO. Query Google'\''s PageSpeed Insights API for both Mobile and Desktop strategies. Check search indexing with Google Search for site:web.dev. Format the output as a side-by-side scorecard table with prioritized fixes.",
    "environment": "remote"
}'

기본 Gemini 모델은 다음을 사용하여 구성할 수 있습니다. agent_config

마이그레이션 체크리스트

  `/gemini-api-dev migrate my app to Gemini 3.8 Flash`

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

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

가격 책정

Gemini 3.8 Flash, Gemini 3.7 Flash, Gemini 3.6 Flash의 경우 2026년 12월 31일까지 Google AI Studio 및 Gemini Enterprise Agent Platform에서 특별 가격을 활용하세요. 표준 가격은 2027년 1월 1일부터 적용됩니다. 전체 가격 책정 등급은 가격 책정 페이지를 참고하세요.

다음 단계

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