Skip to main content
Gemini 네이티브 형식은 이해 및 분석을 위해 이미지, 오디오, 비디오를 직접 수락하며, 샌드박스에서 Python을 실행하는 기본 제공 code_execution 도구를 포함합니다. 아래 예시는 네이티브 호출의 클라이언트 설정을 가정합니다.
APIYI 채널의 두 가지 엄격한 제한:
  1. Files API는 지원되지 않습니다 (client.files.upload()는 Google의 공식 엔드포인트에서만 작동합니다) — 미디어는 인라인으로 전달해야 합니다
  2. 인라인 미디어는 파일당 20MB로 제한됩니다. 더 크면 먼저 압축하거나 프레임을 추출하십시오

이미지 이해

PIL Image를 직접 전달하면 됩니다. SDK가 인코딩을 처리합니다:
바이트는 types.Part.from_bytes를 사용해 명시적으로 전달할 수도 있습니다:

오디오 이해

동영상 이해

동영상은 프레임별로 오디오 트랙과 함께 토큰화되므로, 더 긴 동영상일수록 비용이 더 많이 듭니다. 더 많은 동영상 워크플로: 동영상 이해.

media_resolution을 사용한 비용 제어

미디어의 token 소비량은 해상도에 따라 증가합니다. “대략적인 확인” 작업(분류, 존재 여부 확인)에서는 낮은 해상도를 사용하면 실제 비용을 절감할 수 있습니다:

지원 형식

모두 인라인으로 전달하며, 파일당 최대 20MB입니다.

코드 실행

code_execution 도구를 선언하면 모델이 Python을 작성하고 샌드박스에서 실행한 뒤 결과를 바탕으로 응답합니다 — 계산과 데이터 분석에 이상적입니다:
코드 실행 제한: Python만 지원합니다; 샌드박스에는 네트워크나 파일 시스템 접근 권한이 없으며; 실행 시간은 제한됩니다. 자체 외부 서비스를 호출하려면 함수 호출을 사용하십시오.

관련 링크