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가 가장 우수한 성능을 보였습니다.