코드 실행

Gemini API 코드 실행 기능을 사용하면 모델을 도착할 때까지 결과로부터 반복적으로 학습합니다. 최종 출력을 생성합니다. 이 코드 실행 기능을 사용하여 코드 기반 추론의 이점을 활용하고 텍스트 출력을 생성하는 애플리케이션을 빌드할 수 있습니다. 예를 들어 방정식을 풀거나 텍스트를 처리하는 애플리케이션에서 코드 실행을 사용할 수 있습니다.

코드 실행은 AI 스튜디오와 Gemini API 모두에서 사용할 수 있습니다. AI 스튜디오의 고급 설정에서 코드 실행을 사용 설정할 수 있습니다. Gemini API 는 코드 실행을 도구로 함수 호출 추가 후 모델이 이를 언제 사용할지 결정합니다.

코드 실행 시작하기

이 섹션에서는 빠른 시작과 같이 Gemini SDK를 설치하고 API 키를 구성했다고 가정합니다.

코드 실행과 함수 호출 비교

코드 실행과 함수 호출은 유사한 기능입니다.

  • 코드 실행을 통해 모델이 격리된 고정되어 있는 API 백엔드에서 코드를 실행할 수 있음 환경입니다
  • 함수 호출을 사용하면 모델이 요청하는 함수를 원하는 환경을 구성할 수 있습니다

일반적으로 사용을 처리할 수 있다면 코드 실행을 사용하는 것이 좋습니다. 있습니다. 코드 실행은 사용하기 더 간단하며(사용 설정하기만 하면 됨) 단일 GenerateContent 요청으로 확인되므로(따라서 단일 청구 발생) 기능 호출하면 추가 GenerateContent 요청을 받아 출력을 다시 전송합니다. 각 함수 호출에서 여러 번 발생합니다. 따라서 여러 번의 요금이 발생합니다.

대부분의 경우 자체 함수가 있는 경우 함수 호출을 사용해야 합니다. 실행할 수 있으며, 원하는 경우 코드 실행을 사용해야 합니다 자동으로 Python 코드를 작성 및 실행하고 결과를 반환하도록 API를 제공합니다.

결제

Google Cloud 콘솔에서 코드 실행을 사용 설정하는 데 Gemini API를 사용하는 것이 좋습니다 현재 입력 및 출력 토큰 요율이 적용됩니다.

다음은 코드 실행 비용 청구와 관련하여 알아야 할 몇 가지 사항입니다.

  • 모델에 전달하는 입력 토큰에 대해서만 한 번 청구되며 모델에서 반환하는 최종 출력 토큰에 대해서만 청구됩니다.
  • 생성된 코드를 나타내는 토큰이 출력 토큰으로 집계됩니다.
  • 코드 실행 결과도 출력 토큰으로 집계됩니다.

제한사항

  • 모델은 코드 생성 및 실행만 할 수 있습니다. 미디어 파일과 같은 다른 아티팩트는 반환할 수 없습니다.
  • 이 기능은 파일 I/O 또는 텍스트가 아닌 출력(예: 데이터 플롯 또는 CSV 파일 업로드)과 관련된 사용 사례를 지원하지 않습니다.
  • 코드 실행은 시간 초과가 발생하기 전에 최대 30초 동안 실행될 수 있습니다.
  • 경우에 따라 코드 실행을 사용 설정하면 모델 출력의 다른 영역(예: 스토리 작성)에서 회귀가 발생할 수 있습니다.
  • 각 모델의 코드 사용 능력에는 약간의 차이가 있습니다. 실행할 수 있습니다. Gemini 1.5 Pro가 최고 성능입니다 모델을 기반으로 하고 있습니다.