코드 실행

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

코드 실행은 AI Studio와 Gemini API 모두에서 사용할 수 있습니다. AI 스튜디오에서 오른쪽 패널의 도구에서 코드 실행을 사용 설정할 수 있습니다. Gemini API는 함수 호출과 마찬가지로 코드 실행을 도구로 제공합니다. 코드 실행을 도구로 추가하면 모델에서 이를 사용할 시기를 결정합니다.

코드 실행 환경에는 다음 라이브러리가 포함됩니다. altair, chess, cv2, matplotlib, mpmath, numpy, pandas, pdfminer, reportlab, seaborn, sklearn, statsmodels, striprtf, sympy, tabulate 자체 라이브러리를 설치할 수 없습니다.

코드 실행 시작하기

이 섹션에서는 빠른 시작에 표시된 설정 및 구성 단계를 완료했다고 가정합니다.

입력/출력 (I/O)

Gemini 2.0 Flash부터 코드 실행이 파일 입력과 그래프 출력을 지원합니다. 이러한 새로운 입력 및 출력 기능을 사용하면 CSV 및 텍스트 파일을 업로드하고, 파일에 관해 질문하고, 응답의 일부로 Matplotlib 그래프를 생성할 수 있습니다.

I/O 가격

코드 실행 I/O를 사용하면 입력 토큰과 출력 토큰에 대한 요금이 청구됩니다.

입력 토큰:

  • 사용자 프롬프트

출력 토큰:

  • 모델에서 생성된 코드
  • 코드 환경의 코드 실행 출력
  • 모델에서 생성한 요약

I/O 세부정보

코드 실행 I/O를 사용할 때는 다음과 같은 기술적 세부정보에 유의하세요.

  • 코드 환경의 최대 런타임은 30초입니다.
  • 코드 환경에서 오류가 발생하면 모델에서 코드 출력을 다시 생성할 수 있습니다. 최대 5회까지 할 수 있습니다.
  • 최대 파일 입력 크기는 모델 토큰 창에 의해 제한됩니다. Gemini Flash 2.0을 사용하는 AI 스튜디오에서 최대 입력 파일 크기는 100만 토큰입니다 (지원되는 입력 유형의 텍스트 파일의 경우 약 2MB). 파일의 크기가 너무 큰 경우 AI 스튜디오에서 전송할 수 없습니다.
싱글턴 양방향 (Multimodal Live API)
지원되는 모델 모든 Gemini 2.0 모델 플래시 실험용 모델만
지원되는 파일 입력 유형 .png, .jpeg, .csv, .xml, .cpp, .java, .py, .js, .ts .png, .jpeg, .csv, .xml, .cpp, .java, .py, .js, .ts
지원되는 표시 라이브러리 Matplotlib Matplotlib
다중 도구 사용 아니요

결제

Gemini API에서 코드 실행을 사용 설정하는 데는 추가 비용이 들지 않습니다. 사용 중인 Gemini 모델에 따라 입력 및 출력 토큰의 현재 요율로 요금이 청구됩니다.

다음은 코드 실행에 대한 결제에 대해 알아야 할 몇 가지 사항입니다.

  • 모델에 전달하는 입력 토큰에 대해서만 한 번 청구되며 모델에서 반환하는 최종 출력 토큰에 대해서만 청구됩니다.
  • 생성된 코드를 나타내는 토큰은 출력 토큰으로 집계됩니다. 생성된 코드에는 텍스트와 이미지와 같은 멀티모달 출력이 포함될 수 있습니다.
  • 코드 실행 결과도 출력 토큰으로 집계됩니다.

코드 실행 결제 모델

  • 사용 중인 Gemini 모델에 따라 입력 및 출력 토큰의 현재 요율로 요금이 청구됩니다.
  • Gemini가 응답을 생성할 때 코드 실행을 사용하는 경우 원래 프롬프트, 생성된 코드, 실행된 코드의 결과에 중간 토큰 라벨이 지정되고 입력 토큰으로 청구됩니다.
  • 그런 다음 Gemini는 요약을 생성하고 생성된 코드, 실행된 코드의 결과, 최종 요약을 반환합니다. 출력 토큰으로 청구됩니다.
  • Gemini API는 API 응답에 중간 토큰 수를 포함하므로 초기 프롬프트 외에도 입력 토큰이 추가로 제공되는 이유를 알 수 있습니다.

제한사항

  • 모델은 코드를 생성하고 실행할 수만 있습니다. 미디어 파일과 같은 다른 아티팩트는 반환할 수 없습니다.
  • 경우에 따라 코드 실행을 사용 설정하면 모델 출력의 다른 영역 (예: 스토리 작성)에서 회귀가 발생할 수 있습니다.
  • 코드 실행을 성공적으로 사용하는 모델의 기능은 서로 다릅니다.