이 문서에서는 Gemini API의 v1
버전과 v1beta 버전 간의 차이점을 개략적으로 설명합니다.
- v1: 안정화 버전의 API입니다. 안정화 버전의 기능은 메이저 버전의 수명 기간 동안 완전히 지원됩니다. 호환성이 손상되는 변경사항이 있는 경우 새로운 메이저 버전의 API가 생성되고 기존 버전은 적절한 기간이 지난 후 지원 중단됩니다.
호환성이 손상되지 않는 변경사항은 메이저 버전을 변경하지 않고도 API에 도입될 수 있습니다. Interactions API 및 핵심 기능은 일반적으로
v1에서 사용할 수 있습니다. - v1beta: 이 버전에는 활발히 개발 중인 초기 기능이 포함되어 있습니다.
v1beta의 기능은 의견을 바탕으로 개선되면서 변경될 수 있지만, 안정화 버전으로 승격되기 전에 새로운 기능을 사용해 볼 수 있습니다.
기능 및 기능 지원
다음 표에는 v1 (GA)
및 v1beta (베타)에서 사용할 수 있는 기능이 자세히 나와 있습니다. 핵심 API 기능 및 도구는 달리 지정되지 않는 한 상호작용 API와 generateContent 모두에 적용됩니다.
| 기능 | v1 | v1beta |
|---|---|---|
| 핵심 API 기능 | ||
| Interactions API | ||
| 함수 호출 | ||
| 구조화된 출력 | ||
| 사고 / 추론 | ||
| 시스템 안내 | ||
| 오디오 출력 (음성 구성) | ||
| 서비스 등급 (우선순위 / 유연) | ||
| 도구 | ||
| 코드 실행 도구 | ||
| Google 검색 그라운딩 | ||
| Google 지도 그라운딩 | ||
| URL 컨텍스트 도구 | ||
| 파일 검색 도구 | ||
| 컴퓨터 사용 도구 | ||
| MCP 서버 도구 | ||
| 실시간 API | ||
| Live API (WebSocket) | ||
| Live Music API | ||
| 단기 토큰 (Live API) | ||
| 플랫폼 API | ||
| 모델 API | ||
| 파일 서비스 경로 | ||
| 파일 검색 저장소 경로 | ||
| 에이전트 API | ||
| 웹훅 API | ||
| 컨텍스트 캐싱 |
- - 지원됨
SDK에서 API 버전 구성
Gemini API SDK는 기본적으로 v1beta를 사용하지만 다음 코드 샘플과 같이 API 버전을 설정하여 버전을 명시적으로 지정할 수 있습니다.
Python
from google import genai
client = genai.Client(http_options={'api_version': 'v1'})
interaction = client.interactions.create(
model='gemini-3.6-flash',
input="Explain how AI works",
)
print(interaction.output_text)
JavaScript
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({
httpOptions: { apiVersion: "v1" },
});
async function main() {
const interaction = await ai.interactions.create({
model: "gemini-3.6-flash",
input: "Explain how AI works",
});
console.log(interaction.output_text);
}
await main();
REST
curl -X POST "https://generativelanguage.googleapis.com/v1/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",
}'