В этом документе представлен общий обзор различий между версиями v1 и v1beta API Gemini.
- v1 : Стабильная версия API. Функции стабильной версии полностью поддерживаются на протяжении всего срока службы основной версии. В случае внесения каких-либо критических изменений будет создана следующая основная версия API, а существующая версия будет объявлена устаревшей по истечении разумного периода времени. В API могут быть внесены изменения, не нарушающие обратную совместимость, без изменения основной версии.
- v1beta : Эта версия включает в себя ранние функции, которые могут находиться в разработке и могут претерпеть существенные изменения. Также нет гарантии, что функции бета-версии будут перенесены в стабильную версию. Если вам необходима стабильность в производственной среде и вы не можете рисковать внесением существенных изменений, вам не следует использовать эту версию в производственной среде.
| Особенность | v1 | v1beta |
|---|---|---|
| Создание контента — ввод только текста | ||
| Создание контента — ввод текста и изображений. | ||
| Создание контента - текстовый вывод | ||
| Создание контента — многоэтапные диалоги (чат) | ||
| Генерация контента - вызовы функций | ||
| Создание контента — потоковая передача | ||
| Встраивание контента — ввод только текста | ||
| Сгенерировать ответ | ||
| Семантический поиск | ||
| API взаимодействий |
- - Поддерживается
- - Никогда не будет поддержано
Настройка версии API в SDK
В стандартной версии SDK API Gemini используется v1beta , но вы можете выбрать другие версии, указав версию API, как показано в следующем примере кода:
Python
from google import genai
client = genai.Client(http_options={'api_version': 'v1alpha'})
response = client.models.generate_content(
model='gemini-2.0-flash',
contents="Explain how AI works",
)
print(response.text)
JavaScript
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({
httpOptions: { apiVersion: "v1alpha" },
});
async function main() {
const response = await ai.models.generateContent({
model: "gemini-2.0-flash",
contents: "Explain how AI works",
});
console.log(response.text);
}
await main();
ОТДЫХ
curl "https://generativelanguage.googleapis.com/v1/models/gemini-1.5-flash:generateContent" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
"contents": [{
"parts":[{"text": "Explain how AI works."}]
}]
}'