code_execution 도구를 포함합니다. 아래 예시는 네이티브 호출의 클라이언트 설정을 가정합니다.
이미지 이해
PIL Image를 직접 전달하면 됩니다. SDK가 인코딩을 처리합니다:types.Part.from_bytes를 사용해 명시적으로 전달할 수도 있습니다:
오디오 이해
동영상 이해
media_resolution을 사용한 비용 제어
미디어의 token 소비량은 해상도에 따라 증가합니다. “대략적인 확인” 작업(분류, 존재 여부 확인)에서는 낮은 해상도를 사용하면 실제 비용을 절감할 수 있습니다:지원 형식
모두 인라인으로 전달하며, 파일당 최대 20MB입니다.
코드 실행
code_execution 도구를 선언하면 모델이 Python을 작성하고 샌드박스에서 실행한 뒤 결과를 바탕으로 응답합니다 — 계산과 데이터 분석에 이상적입니다:
코드 실행 제한: Python만 지원합니다; 샌드박스에는 네트워크나 파일 시스템 접근 권한이 없으며; 실행 시간은 제한됩니다. 자체 외부 서비스를 호출하려면 함수 호출을 사용하십시오.
관련 링크
- 이 그룹: Native Calls · Cache Billing · Function Calling
- 사용 사례: Video Understanding · Vision Understanding
- 공식 Google 문서:
ai.google.dev/gemini-api/docs/vision