Gemini API 코드 실행 기능을 사용하면 모델이 Python 코드를 생성 및 실행하고 최종 출력에 도달할 때까지 결과로부터 반복적으로 학습할 수 있습니다. 이 코드 실행 기능을 사용하면 코드 기반 추론의 이점을 누리고 텍스트 출력을 생성하는 애플리케이션을 빌드할 수 있습니다. 예를 들어 방정식을 풀거나 텍스트를 처리하는 애플리케이션에서 코드 실행을 사용할 수 있습니다.
코드 실행은 AI Studio와 Gemini API 모두에서 사용할 수 있습니다. AI Studio의 고급 설정에서 코드 실행을 사용 설정할 수 있습니다. Gemini API는 함수 호출과 마찬가지로 코드 실행을 도구로 제공합니다. 코드 실행을 도구로 추가하면 모델이 이를 언제 사용할지 결정합니다.
코드 실행 시작하기
 ai.google.dev에서 보기
|
 Google Colab에서 실행
|
 GitHub에서 소스 보기
|
이 섹션에서는 quickstart에 나온 것처럼 Gemini SDK를 설치하고 API 키를 구성했다고 가정합니다.
코드 실행과 함수 호출 비교
코드 실행과 함수 호출은 비슷한 기능입니다.
- 코드 실행을 통해 모델이 격리된 고정된 환경의 API 백엔드에서 코드를 실행할 수 있습니다.
- 함수 호출을 사용하면 원하는 환경에서 모델이 요청하는 함수를 실행할 수 있습니다.
일반적으로 사용 사례를 처리할 수 있는 코드 실행을 사용하는 것이 좋습니다. 코드 실행은 사용하기 쉬우며(사용 설정하기만 하면) 단일 GenerateContent 요청으로 확인되므로 단일 요금이 발생합니다. 함수 호출 시에는 각 함수 호출의 출력을 다시 보내기 위해 추가 GenerateContent 요청이 필요합니다. 따라서 여러 번의 요금이 발생합니다.
대부분의 경우 로컬에서 실행하려는 자체 함수가 있는 경우 함수 호출을 사용해야 하며, API가 자동으로 Python 코드를 작성 및 실행하고 결과를 반환하도록 하려면 코드 실행을 사용해야 합니다.
청구
Gemini API에서 코드 실행을 사용 설정하는 데는 추가 요금이 없습니다. 입력 및 출력 토큰의 현재 요율로 요금이 청구됩니다.
다음은 코드 실행 비용 청구와 관련하여 알아야 할 몇 가지 사항입니다.
- 모델에 전달한 입력 토큰에 대해서는 한 번만 요금이 청구되며 모델이 반환하는 최종 출력 토큰에 대한 요금이 청구됩니다.
- 생성된 코드를 나타내는 토큰이 출력 토큰으로 집계됩니다.
- 코드 실행 결과도 출력 토큰으로 집계됩니다.
제한사항
- 모델은 코드 생성 및 실행만 할 수 있습니다. 미디어 파일과 같은 다른 아티팩트는 반환할 수 없습니다.
- 이 기능은 파일 I/O 또는 텍스트가 아닌 출력과 관련된 사용 사례(예: 데이터 플롯)는 지원하지 않습니다.
- 시간 초과 전에 최대 30초 동안 코드 실행을 실행할 수 있습니다.
- 경우에 따라 코드 실행을 사용 설정하면 모델 출력의 다른 영역에서 회귀가 발생할 수 있습니다 (예: 스토리 작성).
- 모델마다 코드 실행을 성공적으로 사용하는 기능에는 약간의 차이가 있습니다. 테스트 결과에 따르면 Gemini 1.5 Pro가 가장 성능이 좋은 모델입니다