이제 Gemini 3.8 Flash를 사용할 수 있습니다. 사용해 보기.

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

Gemini 3.8 Flash의 새로운 기능

Gemini 3.8 Flash (gemini-3.8-flash)가 정식 버전 (GA)으로 출시되어 프로덕션에 사용할 수 있습니다. 장기 소프트웨어 엔지니어링, 자율 에이전트, 복잡한 엔터프라이즈 워크플로를 위해 설계된 Google의 가장 지능적인 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의 신규 할인 가격으로 제공됩니다. 자세한 내용은 가격 책정을 참고하세요.	장기 소프트웨어 엔지니어링, 자율 에이전트, 복잡한 엔터프라이즈 워크플로를 위해 설계된 Google의 가장 지능적인 Flash 모델입니다.

Gemini 3.8 Flash는 1백만 개의 토큰 컨텍스트 윈도우, 최대 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 params =
    CreateModelInteraction.builder()
        .model(Model.of("gemini-3.8-flash"))
        .input(
            InteractionsInput.of(
                "Write a three.js script that renders a realistic 3D black hole."))
        .build();

Interaction interaction =
    client.interactions.create(CreateInteractionRequestBody.of(params)).interaction().get();

System.out.println(interaction.outputText().orElse(""));

Go

package main

import (
    "context"
    "fmt"
    "log"

    "google.golang.org/genai"
    "google.golang.org/genai/interactions/models/interactions"
    "google.golang.org/genai/interactions/models/operations"
)

func main() {
    ctx := context.Background()
    client, err := genai.NewClient(ctx, nil)
    if err != nil {
        log.Fatal(err)
    }

    res, err := client.Interactions.Create(ctx, operations.CreateInteractionRequest{
        Body: operations.NewCreateInteractionRequestBody(interactions.CreateModelInteraction{
            Model: interactions.Model("gemini-3.8-flash"),
            Input: interactions.NewInteractionsInput("Write a three.js script that renders a realistic 3D black hole."),
        }),
    })
    if err != nil {
        log.Fatal(err)
    }
    if res.Interaction.OutputText != nil {
        fmt.Println(*res.Interaction.OutputText)
    }
}

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.GenerationConfig;
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.interactions.ThinkingLevel;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;

Client client = new Client();

CreateModelInteraction params =
    CreateModelInteraction.builder()
        .model(Model.of("gemini-3.8-flash"))
        .input(
            InteractionsInput.of(
                "Analyze this payment processing pipeline for race conditions during retry attempts and rewrite the transaction locks safely."))
        .generationConfig(
            GenerationConfig.builder()
                .thinkingLevel(ThinkingLevel.MEDIUM) // Balanced reasoning effort for complex tasks
                .build())
        .build();

Interaction interaction =
    client.interactions.create(CreateInteractionRequestBody.of(params)).interaction().get();

System.out.println(interaction.outputText().orElse(""));

Go

package main

import (
    "context"
    "fmt"
    "log"

    "google.golang.org/genai"
    "google.golang.org/genai/interactions/models/interactions"
    "google.golang.org/genai/interactions/models/operations"
)

func main() {
    ctx := context.Background()
    client, err := genai.NewClient(ctx, nil)
    if err != nil {
        log.Fatal(err)
    }

    res, err := client.Interactions.Create(ctx, operations.CreateInteractionRequest{
        Body: operations.NewCreateInteractionRequestBody(interactions.CreateModelInteraction{
            Model: interactions.Model("gemini-3.8-flash"),
            Input: interactions.NewInteractionsInput("Analyze this payment processing pipeline for race conditions during retry attempts and rewrite the transaction locks safely."),
            GenerationConfig: &interactions.GenerationConfig{
                ThinkingLevel: interactions.ThinkingLevelMedium.ToPointer(), // Balanced reasoning effort for complex tasks
            },
        }),
    })
    if err != nil {
        log.Fatal(err)
    }
    if res.Interaction.OutputText != nil {
        fmt.Println(*res.Interaction.OutputText)
    }
}

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 관리 에이전트의 Antigravity agent가 이제 기본적으로 Gemini 3.8 Flash로 빌드됩니다.

Python

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    agent="antigravity-preview-09-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-09-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.AgentOption;
import com.google.genai.gaos.models.interactions.CreateAgentInteraction;
import com.google.genai.gaos.models.interactions.CreateAgentInteractionEnvironment;
import com.google.genai.gaos.models.interactions.Interaction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;

Client client = new Client();

CreateAgentInteraction params =
    CreateAgentInteraction.builder()
        .agent(AgentOption.of("antigravity-preview-09-2026"))
        .input(
            InteractionsInput.of(
                "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(CreateAgentInteractionEnvironment.of("remote"))
        .build();

Interaction interaction =
    client.interactions.create(CreateInteractionRequestBody.of(params)).interaction().get();

System.out.println(interaction.outputText().orElse(""));

Go

package main

import (
    "context"
    "fmt"
    "log"

    "google.golang.org/genai"
    "google.golang.org/genai/interactions/models/interactions"
    "google.golang.org/genai/interactions/models/operations"
)

func main() {
    ctx := context.Background()
    client, err := genai.NewClient(ctx, nil)
    if err != nil {
        log.Fatal(err)
    }

    res, err := client.Interactions.Create(ctx, operations.CreateInteractionRequest{
        Body: operations.NewCreateInteractionRequestBody(interactions.CreateAgentInteraction{
            Agent: interactions.AgentOption("antigravity-preview-09-2026"),
            Input: interactions.NewInteractionsInput(
                "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: genai.Ptr(interactions.NewCreateAgentInteractionEnvironment("remote")),
        }),
    })
    if err != nil {
        log.Fatal(err)
    }
    if res.Interaction.OutputText != nil {
        fmt.Println(*res.Interaction.OutputText)
    }
}

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

가격 책정

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

다음 단계

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

Gemini 3.8 Flash의 새로운 기능

새 모델

빠른 시작

Python

JavaScript

자바

Go

REST

Gemini 3.8 Flash의 새로운 기능

추론 수준 이해하기

Python

JavaScript

자바

Go

REST

Antigravity 에이전트 업데이트됨

Python

JavaScript

자바

Go

REST

마이그레이션 체크리스트

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

가격 책정

다음 단계

기타 모델