Google Gemini 모델

모델군에서 적합한 모델 선택

작업을 처리할 만한 가장 작은 모델로 시작하고 더 강한 후보 하나와 같은 작업을 비교하세요. 채택 결과의 품질, 지연, 안정성과 총비용으로 고르세요.

• 멀티모달 코딩·AI 에이전트 작업은 안정 버전 Gemini 3.7 Flash로 시작하세요.
• 새 기능보다 검증된 동작 유지가 중요하면 Gemini 3.6 Flash를 계속 사용하세요.
• 미리보기 모델은 즉시 끌 수 있고 검증된 대체 모델이 있을 때만 사용하세요.

입력·출력·컨텍스트·도구

• Gemini 3.7 Flash는 텍스트, 이미지, 영상, 오디오와 PDF를 입력받고 텍스트를 반환합니다.
• 공개 한도는 입력 1,048,576, 출력 65,536 토큰입니다.
• 함수 호출, 구조화 출력, 코드 실행, 검색 근거 답변, 파일 검색과 URL 내용 활용을 지원합니다.
• 추론 수준은 low, medium, high이며 기본값은 medium입니다.

이 모델군에 적합한 작업

먼저 시험할 후보입니다. 모든 작업에 맞는 것은 아니니 실제 프롬프트, 도구와 합격 기준으로 검증하세요.

• 같은 요청 형식으로 영상·오디오·문서 이해.
• 구조화 도구와 큰 컨텍스트를 함께 쓰는 코딩 에이전트.
• 최신 정보가 중요한 분석에서 웹 검색 활용.
• 명확한 스키마를 이용한 대량 추출·분류.

추론·컨텍스트·비용 관리

입력 단가만 비교하지 마세요. 출력, 캐시 읽기·쓰기, 장문 구간, 추론 토큰, 도구, 재시도와 매 대화의 기록 재전송도 포함하세요.

• 반복되는 긴 공통 부분은 컨텍스트 캐시를 쓰고 실제 트래픽에서 비용 효과를 비교하세요.
• 비동기 작업은 배치 처리로 공식 비용을 줄일 수 있지만 경로 지원을 확인해야 합니다.
• 운영에서는 바뀌는 미리보기 별칭 대신 정확한 안정 버전 ID를 고정하세요.

최소 요청 보내기

예시는 표의 첫 공식 모델 ID를 사용합니다. API 키의 모델 목록에 다른 ID가 표시되면 그 값을 그대로 복사하세요.

curl https://app.llmfly.ai/v1/chat/completions \
  -H "Authorization: Bearer $LLMFLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-pro-preview",
    "messages": [{"role": "user", "content": "Explain this request in three bullets."}],
    "stream": false
  }'

제한·호환성 안내

• Gemini 3.7 Flash는 오디오·이미지 생성을 공개하지 않았고 Live API를 지원하지 않습니다.
• 컴퓨터 조작은 미리보기 기능이며 별도 위험 관리가 필요합니다.
• 요금과 미리보기 상태는 바뀔 수 있습니다. 출시 전에 다시 확인하세요.

운영 전 평가 목록

• 시험 전에 합격 기준을 정하고 대표 작업 20~50개를 실행하세요.
• 첫 토큰 시간, 전체 지연, 입력·출력 토큰, 도구 재시도와 성공 작업당 비용을 측정하세요.
• 앱에서 쓰는 엔드포인트, 스트리밍, 도구 스키마와 구조화 출력을 시험하세요.
• 400, 401, 404, 429과 일시적 5xx 처리를 확인하고 재시도 횟수를 제한하세요.
• 모델 ID를 설정으로 관리하고 운영 요청을 옮기기 전에 대체 모델을 검증하세요.

모델 목록에서 확인할 내용

모델 목록에서 API 키가 쓸 수 있는 ID, 과금 배율, 이용 가능 여부, 엔드포인트와 호환성을 확인할 수 있습니다. 배포 전 작은 요청으로 검증하세요.

• Gemini 3.7 Flash는 low, medium, high 추론 수준을 지원합니다.
• 공개된 입력 유형은 텍스트, 이미지, 영상, 파일과 오디오입니다.
• 미리보기 별칭은 바뀔 수 있습니다. 작업에 맞는 안정 버전이 있으면 운영에서 정확한 ID를 쓰세요.

조사한 모델의 실제 ID 확인

위 모델 페이지의 공식 ID를 확인한 뒤 모델 목록에서 API 키가 쓸 수 있는 ID를 확인하세요. ID를 설정에 두면 앱을 다시 작성하지 않고 검토·변경할 수 있습니다.