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