이 문서에서는 Gemini API의 v1 버전과 v1beta 버전 간의 차이점을 개략적으로 설명합니다.
- v1: API의 안정화 버전입니다. 안정화 버전의 기능은 메인 버전의 전체 기간 동안 완전히 지원됩니다. 중대한 변경사항이 있는 경우 API의 다음 주요 버전이 생성되고 합당한 기간이 지나면 기존 버전이 지원 중단됩니다. 메인 버전을 변경하지 않고도 API에 비중단 변경사항이 도입될 수 있습니다.
- v1beta: 이 버전에는 개발 중일 수 있으며 급격한 변경사항이 적용될 수 있는 사전 체험판 기능이 포함되어 있습니다. 또한 베타 버전의 기능이 안정화 버전으로 이전된다고 보장할 수 없습니다. 이러한 불안정성으로 인해 이 버전으로 프로덕션 애플리케이션을 출시하지 않는 것이 좋습니다.
| 기능 | v1 | v1beta |
|---|---|---|
| 콘텐츠 생성 - 텍스트 전용 입력 | ||
| 콘텐츠 생성 - 텍스트 및 이미지 입력 | ||
| 콘텐츠 생성 - 텍스트 출력 | ||
| 콘텐츠 생성 - 멀티턴 대화 (채팅) | ||
| 콘텐츠 생성 - 함수 호출 | ||
| 콘텐츠 생성 - 스트리밍 | ||
| 콘텐츠 삽입 - 텍스트 전용 입력 | ||
| 답변 생성 | ||
| 시맨틱 검색기 |
- - 지원됨
- - 지원되지 않음
SDK에서 API 버전 구성
Gemini API SDK는 기본적으로 v1beta이지만 다음 코드 샘플과 같이 API 버전을 설정하여 v1를 대신 사용할 수 있습니다.
Python
Python SDK google.generativeai는 v1beta를 사용하며 API 버전을 전환하는 메서드를 제공하지 않습니다.
하위 수준 Python 클라이언트 라이브러리인 google.ai.generativelanguage는 다른 버전을 별도의 모듈인 google.ai.generativelanguage_v1 및 google.ai.generativelanguage_v1beta로 노출합니다. 기본값은 v1beta입니다.
import google.ai.generativelanguage_v1 as glm
client = glm.GenerativeServiceClient(
client_options=dict(api_key=YOUR_API_KEY))
response = client.generate_content({
"model": "models/gemini-1.5-flash",
"contents": [ {"parts": [ {"text": "Explain how AI works"}]}]
})
print(type(response).to_dict(response))
Node.js
const { GoogleGenerativeAI } = require("@google/generative-ai");
const genAI = new GoogleGenerativeAI("YOUR_API_KEY");
const model = genAI.getGenerativeModel({ model: 'gemini-1.5-flash' }, { apiVersion: 'v1' });
const prompt = "Explain how AI works";
const result = await model.generateContent(prompt);
console.log(result.response.text());
REST
curl "https://generativelanguage.googleapis.com/v1/models/gemini-1.5-flash:generateContent?key=YOUR_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
"contents": [{
"parts":[{"text": "Write a story about a magic backpack."}]
}]
}'