Gemini 4 Argon을 지금 이용 가능합니다. 사용해 보기.

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

Gemini 4 Argon의 새로운 기능

Gemini 4 Argon (gemini-4-argon)은 Google의 최신 모델이자 가장 강력한 모델입니다. 복잡한 코딩, 에이전트형, 수학, 과학 작업에서 더 나은 결과를 얻기 위해 어려운 문제를 더 길게 추론할 수 있습니다. Gemini 4 Argon은 Gemini API와 Google AI Studio를 통해 사용할 수 있습니다.

Gemini 4 Argon은 통합된 100만 입력-출력 토큰 한도, 최대 100만 토큰의 긴 디코딩, 조정 가능한 사고 수준 (low, medium, high)을 지원합니다.

AI Studio에서 사용해 보기

Gemini 4 Argon 및 AI Studio를 사용하여 처음부터 앱을 빌드합니다.

앱 갤러리

Gemini 4 Argon으로 빌드된 앱을 재생하고 리믹스합니다.

시작하기

시작 프롬프트로 Gemini 4 Argon을 시작합니다.

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

새 모델

모델	모델 ID	기본 사고 수준	가격 책정	설명
Gemini 4 Argon	`gemini-4-argon`	`medium`	2026년 11월 30일까지 입력 토큰 100만 개당 $2, 출력 토큰 100만 개당 $10의 신규 할인 가격으로 제공됩니다 (이후 입력 100만 개당 $4, 출력 100만 개당 $20). 자세한 내용은 가격 책정을 참조하세요.	실제 소프트웨어 엔지니어링 및 지식 작업 작업 전반에서 깊이와 정확성으로 가장 어려운 문제를 해결하도록 빌드된 Google의 가장 강력한 모델입니다.

빠른 시작

다음 예시를 사용하여 권장 기본 thinking_level (medium) 및 64K 출력 토큰 한도로 gemini-4-argon에 요청을 전송합니다.

Python

pip install -U "google-genai>=2.30.1"

from google import genai
from google.genai import types

client = genai.Client()

response = client.models.generate_content(
    model="gemini-4-argon",
    contents="Write a three.js script that renders a realistic 3D black hole with gravitational lensing.",
    config=types.GenerateContentConfig(
        max_output_tokens=65536,
        thinking_config=types.ThinkingConfig(thinking_level="medium"),
    ),
)

print(response.text)

JavaScript

npm install "@google/genai@>=2.29.1"

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

const ai = new GoogleGenAI({});

const response = await ai.models.generateContent({
  model: "gemini-4-argon",
  contents: "Write a three.js script that renders a realistic 3D black hole with gravitational lensing.",
  config: {
    maxOutputTokens: 65536,
    thinkingConfig: {
      thinkingLevel: "medium",
    },
  },
});

console.log(response.text);

REST

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-4-argon:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [{
      "parts": [{"text": "Write a three.js script that renders a realistic 3D black hole with gravitational lensing."}]
    }],
    "generationConfig": {
      "maxOutputTokens": 65536,
      "thinkingConfig": {
        "thinkingLevel": "medium"
      }
    }
  }'

Gemini 4 Argon의 새로운 기능

통합된 100만 입력-출력 토큰 한도: 입력, 사고, 출력 토큰은 단일 100만 토큰 창을 공유하며, 스트리밍이 아닌 호출의 경우 요청당 32K, 스트리밍 호출의 경우 스트림당 64K의 한도가 적용됩니다.
최대 100만 토큰의 긴 디코딩: 모델은 요청당 한도를 초과하여 최대 100만 토큰에서 입력을 뺀 값까지 생성할 수 있습니다. 최신 Google 생성형 AI SDK는 기본적으로 계속됩니다.
에이전트형 동영상 이해 (정식 버전): 에이전트형 동영상 이해를 이제 일반적으로 사용할 수 있습니다.
관리형 에이전트에서 지원됨: Gemini 관리형 에이전트의 Antigravity 에이전트가 이제 Gemini 4 Argon을 지원합니다.

자세한 내용은 Gemini 4 Argon 모델 페이지를 참고하세요. 가격 책정에 대한 자세한 내용은 가격 책정 페이지를 참고하세요.

더 큰 출력 및 긴 디코딩

작업에 심층적인 추론이 필요한 경우 Gemini 4 Argon은 더 길게 생각하고 더 열심히 작업하여 복잡한 수학, 과학, 코딩 문제를 단일 생성으로 완료할 수 있습니다.

통합된 100만 입력-출력 토큰 한도: Argon은 사고 및 출력을 합하여 최대 100만 토큰에서 입력 토큰을 뺀 값을 사용할 수 있습니다.
사고 토큰은 max_output_tokens에 포함됨: 어려운 작업에서 모델은 더 나은 답을 얻기 위해 max_output_tokens 예산을 더 많이 사용합니다. thinking_level을 사용하여 토큰 사용을 제어합니다.
요청당 한도 (64K 스트리밍 / 32K 비스트리밍): 하나의 스트리밍 요청은 최대 65,536개의 토큰을 반환합니다. 하나의 비스트리밍 요청은 최대 32,768개의 토큰을 반환하며, 이는 Gemini 3.x의 65,536개에서 감소한 수치입니다. REST 호출의 경우 이러한 한도가 기본값이기도 합니다.

최신 Google 생성형 AI SDK는 기본적으로 긴 디코딩을 실행합니다. Python google-genai 2.30.1 이상 또는 JavaScript @google/genai 2.29.1 이상을 사용합니다.

이러한 버전에서는 automatic_continuation이 기본적으로 True이므로 설정할 필요가 없습니다. 요청당 한도보다 높은 max_output_tokens를 설정하면 모델이 완료되거나 max_output_tokens에 도달할 때까지 generate_content 및 generate_content_stream이 요청 간에 자동으로 계속되어 하나의 결합된 응답을 반환합니다.

response = client.models.generate_content(
    model="gemini-4-argon",
    contents="Write a complete, rigorous proof of the prime number theorem.",
    config=types.GenerateContentConfig(
        max_output_tokens=262144,
        thinking_config=types.ThinkingConfig(thinking_level="high"),
        automatic_continuation=True,  # Default.
    ),
)

루프를 직접 실행하려면 automatic_continuation=False를 설정합니다. REST를 호출하거나 이전 SDK를 사용하는 경우 요청은 요청당 한도에서 중지됩니다. REST 루프, 서드 파티 프레임워크, 토큰 수, 긴 디코딩을 사용하는 시점에 관한 내용은 긴 디코딩 가이드를 참고하세요.

출력 토큰 한도 설정

max_output_tokens는 모든 연속 요청을 포함하여 생성의 총 사고 및 출력 토큰을 설정합니다. 사고가 답을 짧게 자르지 않도록 충분히 높게 설정합니다. 어려운 프롬프트가 모두 사용하는 경우 지출을 제한할 수 있도록 충분히 낮게 설정합니다.

다음 안내를 시작점으로 사용하세요.

표준 작업: 기본값을 유지합니다.
한도가 32K 미만인 기존 앱: max_output_tokens를 32,768로 올립니다. 토큰을 더 적게 사용하려면 thinking_level을 낮춥니다.
이전에 32K 토큰 이상을 사용한 작업: max_output_tokens를 65,536으로 설정합니다.
복잡한 추론 및 코딩: max_output_tokens를 131,072 또는 262,144로 설정합니다(최대 1,048,576에서 입력 토큰을 뺀 값).

요청이 모든 max_output_tokens를 사용하는 경우 finish_reason: "MAX_TOKENS"를 반환하고 continuation_token를 포함합니다. 재개하거나 다시 시작할 수 있습니다.

체크포인트에서 재개: 최신 continuation_token과 더 높은 max_output_tokens로 원래 요청을 전송합니다. max_output_tokens를 올리지 않으면 요청이 400 INVALID_ARGUMENT를 반환합니다.
다시 시작: 더 높은 max_output_tokens와 continuation_token 없이 원래 요청을 전송합니다.

사고 수준 이해

사고 수준은 Gemini 4 Argon의 품질, 지연 시간, 토큰 사용을 제어하는 기본 요소입니다.

사고 수준	토큰 사용	용도
`low`	가장 적은 토큰, 가장 짧은 지연 시간	간단한 작업 및 비용에 민감한 작업. 가벼운 사고가 필요한 분석 및 쓰기 작업에도 적합합니다. 어려운 작업에서 품질이 저하될 수 있습니다.
`medium` (기본값)	균형	복잡한 코드 및 에이전트형 사용 사례를 비롯한 대부분의 작업에 권장됩니다.
`high`	가장 많은 토큰, 가장 느린 첫 번째 토큰	복잡한 추론, 어려운 수학 및 과학, 가장 어려운 코드 또는 에이전트 작업. 긴 출력을 위한 긴 디코딩과 잘 어울립니다.

한도가 답을 짧게 자르지 않도록 높은 max_output_tokens로 세 가지 수준 모두에서 평가를 실행합니다. 그런 다음 품질 기준을 충족하는 가장 낮은 thinking_level을 선택합니다.

마이그레이션 체크리스트

  `/gemini-api-dev migrate my app to Gemini 4 Argon`

gemini-4-argon으로 마이그레이션

모델 ID 업데이트: 모델 문자열을 gemini-4-argon으로 변경합니다.
`max_output_tokens`를 명시적으로 설정max_output_tokens: 기본값은 스트리밍 및 SDK 호출의 경우 64K, 스트리밍이 아닌 REST 호출의 경우 32K입니다.
32K 미만의 한도 올리기: 32K 미만의 한도를 32,768 이상으로 올립니다. thinking_level을 사용하여 토큰 지출을 줄입니다.
긴 디코딩 계획: 요청당 한도를 초과하는 작업의 경우 최신 SDK를 사용하거나 continuation_token 루프를 추가합니다.
thinking_budget을 thinking_level로 바꾸기: thinking_budget은 여전히 작동하며 가장 가까운 thinking_level에 매핑되지만 경고를 반환합니다. low, medium, high에서 워크로드를 테스트합니다.
명시적 컨텍스트 캐싱 사용 중지: 명시적 캐싱 (cachedContents / caches.create)은 Gemini 4 Argon에서 지원되지 않으며 오류를 반환합니다. GenerateContentConfig에서 cached_content를 만들거나 전달하는 호출을 삭제합니다. 암시적 캐싱은 기본적으로 4,096개 이상의 토큰 프롬프트에 사용 설정되며 캐시 적중 시 캐시된 입력 토큰을 95% 할인합니다.
지원 중단된 매개변수 삭제: 요청에서 temperature, top_p, top_k, candidate_count를 삭제합니다. 제공된 경우 샘플링 매개변수는 무시됩니다.
클라이언트 제한 시간 늘리기: HTTP 클라이언트 제한 시간을 호출당 20분 이상으로 설정합니다.
사고 서명 유지: 멀티턴 및 함수 호출 요청에서 사고 서명을 포함한 전체 대화 기록을 전달합니다.

가격 책정

Gemini 4 Argon은 2026년 11월 30일까지 신규 할인 가격으로 제공됩니다.

입력 토큰: 토큰 100만 개당 $2.00 (2026년 12월 1일부터 $4.00)
- 캐시된 입력 토큰: 암시적 캐싱은 캐시된 입력을 95% 할인하여 토큰 100만 개당 $0.10 (2026년 12월 1일부터 $0.20)로 할인합니다.
사고 토큰을 포함한 출력 토큰: 토큰 100만 개당 $10.00 (2026년 12월 1일부터 $20.00)

Gemini 4 Argon은 무료 등급 또는 Google AI Pro 요금제에서 사용할 수 없습니다. 전체 가격 책정 등급은 가격 책정 페이지를 참고하세요.

기타 모델

다음 단계

전체 스트리밍, 재연결, 토큰 수 패턴은 긴 디코딩 개발자 가이드를 참고하세요.
사고 가이드에서 사고 수준과 사고 요약이 작동하는 방식을 알아봅니다.
Google AI Studio에서 Gemini 4 Argon을 테스트합니다.