이 가이드에서는 Interactions API를 사용하여 Gemini API를 시작하는 방법을 설명합니다. 1분 이내에 첫 번째 API 호출을 하고 텍스트 생성, 멀티모달 이해, 이미지 생성, 구조화된 출력, 도구, 함수 호출, 에이전트, 백그라운드 실행을 살펴봅니다.
Interactions API는 Python 및 JavaScript SDK와 REST를 통해 사용할 수 있습니다.
1. API 키 가져오기
Gemini API를 사용하려면 요청을 인증하고, 보안 한도를 적용하고, 계정의 사용량을 추적하는 API 키가 있어야 합니다.
- Google AI Studio는 신규 사용자를 위해 프로젝트와 API 키를 자동으로 생성합니다. API 키 페이지에서 복사할 수 있습니다.
- 새 키가 필요한 경우 AI Studio에서 API 키 만들기를 클릭하고 대화상자에 따라 새 키-프로젝트 쌍을 추가합니다.
키를 환경 변수로 설정합니다.
export GEMINI_API_KEY="YOUR_API_KEY"
유료 등급으로 업그레이드
유료 등급으로 업그레이드하면 비율 제한이 증가하며 Cloud Billing을 설정해야 합니다.
- AI Studio API 키 또는 프로젝트 페이지에서 결제 설정을 클릭합니다.
- Cloud Billing 대화상자에 따라 결제 계정을 만들거나 연결하고, 결제 수단을 추가하고, 유료 크레딧으로 최소 10달러 (또는 해당 통화)를 선불합니다.
- Google AI Studio의 대시보드 > 사용량에서 API 사용량을 확인합니다.
자세한 내용은 결제 페이지를 참고하세요.
2. SDK 설치 및 첫 번째 호출 만들기
SDK를 설치하고 단일 API 호출로 텍스트를 생성합니다.
Python
SDK를 설치합니다.
pip install -U google-genai
클라이언트를 초기화하고 요청을 합니다.
from google import genai
client = genai.Client()
interaction = client.interactions.create(
model="gemini-3.6-flash",
input="Explain how AI works in a few words"
)
print(interaction.output_text)
자바스크립트
SDK를 설치합니다.
npm install @google/genai
클라이언트를 초기화하고 요청을 합니다.
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({});
const interaction = await ai.interactions.create({
model: "gemini-3.6-flash",
input: "Explain how AI works in a few words",
});
console.log(interaction.output_text);
REST
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "gemini-3.6-flash",
"input": "Explain how AI works in a few words"
}'
대답:
{
"id": "v1_ChdpQUFvYXI...",
"status": "completed",