Gemini 3.1 Flash Lite Image and Claude Sonnet 5 are now on CometAPI — fast, cost-effective image generation and editing, plus high-performance coding and agent workflows. Try them now

Gemini 3.5 Flash API 사용 방법

CometAPI
AnnaMay 20, 2026
Gemini 3.5 Flash API 사용 방법

Google는 Google I/O 2026에서 Flash 시리즈의 최신작인 Gemini 3.5 Flash를 공개했으며, Flash 등급의 속도와 비용으로 프런티어 수준의 지능을 제공합니다. 2026년 5월 19일 전후에 출시된 이 모델은 고급 추론, 강력한 에이전틱 능력, 멀티모달 이해를 결합하면서도 낮은 지연시간을 유지합니다.

이 모델은 대형 "Pro" 모델의 오버헤드 없이 고성능 AI가 필요한 개발자, 엔터프라이즈, AI 빌더에게 특히 돋보입니다. 주요 에이전틱 및 코딩 벤치마크에서 이전 Pro 모델에 필적하거나 능가하면서도 더 뛰어난 속도와 효율을 제공합니다.

Key Highlights (Featured Snippet Structure):

  • 성능: Terminal-Bench 2.1에서 Gemini 3.1 Pro를 능가(76.2% vs. 70.3%), MCP Atlas(83.6%) 등.
  • 속도: 실시간 및 대량 트래픽용 Flash 수준의 지연시간.
  • 컨텍스트: 입력 토큰 최대 1M, 출력 토큰 64k.
  • 멀티모달: 텍스트, 이미지, 비디오, 오디오, PDF를 네이티브로 처리.
  • 가격: 입력 1M 토큰당 약 $1.50, 출력 1M 토큰당 $9(제공자/플랫폼에 따라 상이).

원활한 통합을 위해 CometAPI는 Gemini 모델(및 다수의 기타 모델)에 대한 통합되고 신뢰할 수 있는 프록시를 제공하며, 향상된 Rate Limit, 간소화된 결제, 폴백 라우팅, 사용량 분석을 지원합니다. Gemini 3.5 Flash로 스케일링하는 프로덕션 앱에 이상적입니다.

What is Gemini 3.5 Flash?

Gemini 3.5 Flash는 대규모 에이전틱 및 코딩 작업에서 지속적인 프런티어 성능을 제공하도록 설계된 Google의 가장 지능적인 Flash 등급 모델입니다. Gemini 3 시리즈를 기반으로 Pro 수준의 추론과 Flash 수준의 효율을 결합합니다.

비용에 초점을 맞춘 경량 "Lite" 변형이나 최대 지능을 우선하는 대형 Pro 모델과 달리, 3.5 Flash는 실제 멀티스텝 시나리오에서 탁월합니다. 하위 에이전트 배치, 빠른 코딩 반복("vibe coding"), 병렬 도구 사용, 다수 턴에 걸친 컨텍스트 유지가 필요한 장기 워크플로에 적합합니다.

Core Capabilities:

  • 멀티모달 입력: 텍스트, 이미지, 비디오, 오디오, PDF.
  • 도구 및 에이전틱 기능: 함수 호출, 코드 실행, 검색 그라운딩, 파일 검색, URL 컨텍스트. (Computer Use 미지원)
  • 사고 모드: 깊이와 속도의 균형을 맞추기 위한 Effort 레벨 구성 가능.
  • 프로덕션 준비 완료: 안정적 버전 관리가 적용된 GA 상태(gemini-3.5-flash).

1M 토큰 컨텍스트를 지원하여, 방대한 문서, 코드베이스, 대화 이력 처리가 가능합니다. 이는 복잡한 에이전트에 필수적입니다.

What's New in Gemini 3.5 Flash

Gemini 3 Flash 및 3.1 Pro 대비, 3.5 Flash는 다음과 같은 대폭 개선을 제공합니다:

  • 에이전틱 성능 개선: 일부 케이스에서 토큰 72% 절감과 함께 장거리 멀티턴 사이버 벤치마크에서 42% 향상.
  • 코딩 개선: 실제 개발자 워크플로용 Terminal-Bench 및 SWE-Bench 변형에서 선도.
  • 향상된 멀티모달 추론: CharXiv(84.2%)와 MMMU-Pro에서 최고 수준 점수.
  • 병렬 하위 에이전트 조정: 복잡한 멀티에이전트 오케스트레이션 네이티브 지원(Antigravity 예시의 코드베이스 마이그레이션, 게임 개발 등으로 입증).
  • 효율성 향상: 지능을 높이면서도 속도를 유지 또는 개선하여 대규모 프로덕션에 적합.

Benchmark Comparison Table:

BenchmarkGemini 3.5 FlashGemini 3 FlashGemini 3.1 ProNotes
Terminal-Bench 2.1 (Agentic)76.2%58.0%70.3%강력한 코딩 우위
MCP Atlas (Multi-step)83.6%62.0%78.2%에이전틱 워크플로
CharXiv (Multimodal)84.2%80.3%83.3%차트 추론
GDPval-AA (Elo)165612041314지식 작업
MMMU-Pro83.6%81.2%80.5%멀티모달

실사용 고객(예: Shopify, Macquarie Bank, Salesforce)은 예측, 문서 처리, 엔터프라이즈 자동화에서의 성과 향상을 보고하고 있습니다.

Behavior Adjustments and Key Changes

Google은 효율성과 일관성을 높이기 위한 중요한 동작 업데이트를 도입했습니다.

New Default Effort Level: Medium

기본 thinking_level이(이전 프리뷰에서는 high) 이제 medium으로 변경되었습니다. 대부분의 작업에서 우수한 결과를 제공하면서 지연시간과 비용을 줄여줍니다. 가장 복잡한 추론에는 high를 사용하세요.

Effort Level Comparison Table:

Effort LevelBest ForLatency/Cost ImpactRecommended Use Cases
minimal빠른 응답최저채팅, 간단한 사실, 기본 라우팅
low적은 단계의 에이전틱/코드낮음분석, 글쓰기, 퀵 도구
medium (default)대부분의 작업균형복잡한 코드, 표준 에이전트
high심층 추론높음어려운 수학, 가장 까다로운 에이전트 작업

Code Example (Python - Setting Thinking Level):

Python

from google import genai
from google.genai import types

client = genai.Client()  # Assumes API key configured via env or auth

response = client.models.generate_content(
    model="gemini-3.5-flash",
    contents="2의 제곱근이 무리수임을 증명하시오.",
    config=types.GenerateContentConfig(
        thinking_config=types.ThinkingConfig(thinking_level="high")
    ),
)
print(response.text)

유사한 패턴은 JavaScript, REST 등에도 적용됩니다.

Thought Preservation

전체 이력(사고 시그니처 포함)을 제공하면 모델이 멀티턴 대화 전반에 걸쳐 중간 추론을 자동으로 유지합니다. 이를 통해 반복 디버깅, 리팩터링, 장시간 에이전트 세션에서 성능이 향상됩니다. Interactions API에서는 추가 API 변경 없이 적용되며, GenerateContent는 전체 이력 전달의 이점을 받습니다.

Parameter Updates (Gemini 3.x Best Practices)

  • temperature, top_p, top_k를 수동으로 설정하는 것은 피하세요 — 기본값이 최적화되어 있습니다.
  • 숫자형 thinking_budget 대신 thinking_level을 사용하세요.
  • 함수 응답 매칭(id, name, count)을 엄격히 준수해야 빈 응답을 방지할 수 있습니다.

How to Access and Use Gemini 3.5 Flash API

1. Access Options:

  1. Google AI Studio(테스트에 가장 쉬움) — 무료 티어 제공.
  2. Gemini API(API 키를 사용한 직접 접근).
  3. Vertex AI / Gemini Enterprise Agent Platform(엔터프라이즈 기능, 더 높은 한도).
  4. CometAPI와 같은 서드파티(여러 제공자 접근 단순화, 분석, 신뢰성에 추천).

Get Started with CometAPI: CometAPI는 단일 엔드포인트로 Gemini 모델 접근을 통합하고, 더 나은 오류 처리, 사용량 대시보드, 비용 알림을 제공합니다. Cometapi.com에서 가입하고 키를 발급받은 뒤, 최소한의 코드 변경으로 gemini-3.5-flash(또는 동등한 모델 ID)로 요청을 라우팅하세요. 여러 API 키 관리나 Rate Limit 직접 대응 없이 스케일링하기에 적합합니다.

2. Basic Setup and Hello World

Python 퀵스타트:

import osfrom google import genaifrom google.genai import types​# Configure client (API key from env or Google auth)genai.configure(api_key=os.environ["GEMINI_API_KEY"])  # Or use Client() with defaults​client = genai.Client()​response = client.models.generate_content(    model="gemini-3.5-flash",    contents="병렬 에이전틱 실행을 세 문장으로 설명하세요.",)print(response.text)

JavaScript 예시:

import { GoogleGenAI } from "@google/genai";​const ai = new GoogleGenAI({});​async function main() {  const response = await ai.models.generateContent({    model: "gemini-3.5-flash",    contents: "병렬 에이전틱 실행을 세 문장으로 설명하세요.",  });  console.log(response.text);}​main();

REST API cURL:

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.5-flash:generateContent" \  -H "x-goog-api-key: $GEMINI_API_KEY" \  -H 'Content-Type: application/json' \  -X POST \  -d '{    "contents": [{      "parts": [{"text": "안녕하세요, Gemini 3.5 Flash!"}]    }]  }'```<grok-card data-id="a39ea3" data-type="citation_card" data-plain-type="render_inline_citation" ></grok-card>​​

3. Advanced Usage: Multimodal, Function Calling, and Agents

Multimodal 예시(이미지 + 텍스트):

# 이미지 파일 또는 바이트를 보유하고 있다고 가정
image_part = types.Part.from_bytes(data=image_bytes, mime_type="image/jpeg")​
response = client.models.generate_content(    model="gemini-3.5-flash",    contents=[image_part, "이 이미지를 자세히 설명하고 개선점을 제안하세요."],)

에이전틱 워크플로를 위한 함수 호출:

도구를 정의하고, 모델이 도구를 호출하도록 한 뒤, 응답을 제공합니다(반드시 id/name을 엄격히 일치).

구조화 출력:

신뢰할 수 있는 JSON 파싱을 위해 응답 스키마를 사용하세요 — 데이터 추출 파이프라인에 적합합니다.

코드 실행 도구:

수학, 데이터 분석 등을 위해 모델이 샌드박스에서 Python 코드를 실행할 수 있도록 활성화하세요.

완전한 에이전틱 설정을 위해서는 Google의 Managed Agents(프리뷰) 고려 또는 Cometapi.com을 사용해 오케스트레이션, 로깅, 비용 관리를 직접 구축하세요.

Advice for Gemini 3.5 Flash API

  1. 기본 Medium Effort를 활용하고 — 필요할 때만 재정의하세요.
  2. 대화/에이전트에서 사고 보존을 위해 전체 이력을 전달하세요.
  3. 반복되는 대용량 프롬프트에는 컨텍스트 캐싱을 사용하세요(큰 비용 절감).
  4. 도구 응답을 엄격히 처리하여 실패를 방지하세요.
  5. 토큰을 모니터링하세요 — 1M 컨텍스트는 강력하지만 잘못 사용하면 비용이 큽니다.
  6. Cometapi.com과 결합 — Flash-Lite로의 폴백 등 지능형 라우팅, 캐싱 레이어, 사용량 대시보드, 통합 오류 처리를 구현해 대량/미션 크리티컬 앱의 비용과 신뢰성을 최적화하세요.

Best Practices for Using Gemini 3.5 Flash API

프롬프트 엔지니어링:

  • 역할이 명확한 구조화 프롬프트(System + User)를 사용하세요.
  • 출력 형식(JSON, Markdown 테이블)을 지정하세요.
  • Chain-of-Thought: '단계별로 생각해 보자...'

비용 최적화:

  • 기본 "medium" Effort를 활용하세요.
  • 지원되는 경우 캐싱을 사용하세요.
  • CometAPI 대시보드로 토큰 사용량을 모니터링하세요.
  • 긴급하지 않은 작업은 배치 처리하세요.

오류 처리 및 신뢰성:

  • 지수 백오프를 사용한 재시도를 구현하세요.
  • CometAPI로 타 모델에 대한 자동 폴백을 사용하세요.

에이전틱 설계:

  • 복잡한 작업을 하위 에이전트로 분해하세요.
  • 채팅 세션 또는 외부 메모리로 상태를 유지하세요.
  • Antigravity 또는 맞춤 오케스트레이션과 결합하세요.

Real-World Applications and Case Studies

  • 코딩 에이전트: 빠른 피드백 루프를 통한 반복 개발.
  • 엔터프라이즈 자동화: 문서 처리, 데이터 추출(예: Box Life Sciences 성과 향상).
  • 멀티모달 분석: 비디오/오디오 + 텍스트 결합으로 풍부한 인사이트.
  • 고객 지원 에이전트: 장문맥 대화 처리.

Cometapi.com을 통한 통합은 팀이 프롬프트/모델 A/B 테스트, 워크플로별 ROI 추적, 인프라 부담 없이 스케일링할 수 있도록 돕습니다.

Comparison: Gemini 3.5 Flash vs. Competitors & Previous Models

Gemini 3.5 Flash는 에이전틱/코딩 사용 사례에서 뛰어난 가격 대비 성능을 제공합니다. 많은 작업에서 완전한 Pro 모델보다 더 빠르고 비용 효율적이며, 순수 지능 격차를 좁힙니다.

When to Choose It:

  • 고처리량 앱(챗봇, 코딩 어시스턴트).
  • 에이전틱 자동화.
  • 속도가 중요한 멀티모달 분석.
  • 예산을 고려하는 프로덕션.

Limitations: 여전히 프리뷰/스테이블 특성의 미세한 차이가 존재할 수 있음; 일부 출력에 대해 이전 Flash 등급보다 가격이 높을 수 있음. 충분히 테스트하세요.

Performance Comparison Table (Approximate, Based on Public Reports):

ModelAgentic StrengthSpeedCost (Input/Output)Best For
Gemini 3.5 FlashHigh (Frontier)Very High$1.50 / $9Agents, Coding, Scale
Gemini 3 FlashMedium-HighHighLowerGeneral Fast Tasks
Gemini 3.1 ProVery HighMediumHigherMax Intelligence
Lite VariantsMediumHighestLowestHigh-Volume Simple

Common Pitfalls and Troubleshooting

  • 함수 응답 불일치 → 빈 출력.
  • 'high' Effort 과도 사용 → 비용/지연 증가.
  • 반복 컨텍스트에 캐싱 미사용.
  • 장시간 세션에서 토큰 한도 초과.

Conclusion: Start Building with Gemini 3.5 Flash Today

Gemini 3.5 Flash는 속도와 비용에 민감한 애플리케이션을 위해 프런티어 AI 역량을 대중화합니다. GA 출시와 함께 medium 기본 Effort, 사고 보존 같은 신중한 동작 업데이트가 더해져 프로덕션 파워하우스로 자리매김했습니다.

Action Steps:

  1. API 키를 받고 테스트하세요.
  2. 위의 코드 예시를 참고해 SDK로 구현하세요.
  3. 프록시, 최적화, 모니터링, 멀티 LLM 지원을 위해 Cometapi.com으로 스마트하게 스케일하세요.
  4. 에이전틱 패턴을 실험하고 결과를 공유하세요.

이 가이드를 따르면 위험과 비용을 최소화하면서 Gemini 3.5 Flash를 효과적으로 활용할 수 있습니다. 현대적 AI 워크플로에 맞춘 원활한 API 관리를 위해 CometAPI를 방문해 지금 통합하세요.

AI 개발 비용을 20% 절감할 준비가 되셨나요?

몇 분 안에 무료로 시작하세요. 무료 체험 크레딧 제공. 신용카드 불필요.

더 보기