TL;DR
Gemini 4 Hydrogen API доступен через Gemini API от Google и через поддерживаемые сторонние шлюзы, такие как CometAPI. Сначала выберите маршрут: используйте Google для специфичных возможностей и управления аккаунтом, или CometAPI — если вам нужен унифицированный шлюз моделей или клиент, совместимый с OpenAI. Начните с небольшого текстового запроса, затем добавляйте стриминг, историю диалога, файлы и инструменты.
Вам понадобится Python 3.10 или новее, ключ для выбранного маршрута и доступ к gemini-4-hydrogen. Необязательный пример на JavaScript требует Node.js 22 или новее. Храните учетные данные в серверной среде на протяжении всего обучения.
Ключевые выводы
- Используйте
gemini-4-hydrogenкак идентификатор модели для Gemini 4 Hydrogen API. - У Google и CometAPI отдельные учетные данные и биллинг. Подберите ключ под выбранную конечную точку.
- Начните с нативного GenerateContent; используйте интерфейс CometAPI, совместимый с OpenAI, если он подходит вашему существующему чат-клиенту.
- Сохраняйте полный ответ модели в истории многошагового диалога, включая сигнатуры, до возврата уточняющего ответа или результата инструмента.
- Сравнивайте фактическое потребление токенов и завершенные задачи при выборе маршрута; стандартный пример цены за токены приведен в разделе с тарифами.
Что такое Gemini 4 Hydrogen API?
Google представил Hydrogen 12 ноября 2026 года. API принимает подсказки и поддерживаемые файлы, затем возвращает сгенерированный текст или структурированные вызовы функций, которые обрабатывает ваше приложение. Вам не нужно хостить модель самостоятельно.
Начните с запроса, содержащего только текст, и проверьте возвращенный текст, причину завершения и использование токенов, прежде чем добавлять инструменты или файлы. После того как это заработает, добавьте состояние диалога или подключите инструмент только для чтения, вместо того чтобы сразу строить весь рабочий процесс.
Спецификации API Gemini 4 Hydrogen
| Характеристика | Заявленная возможность модели по данным Google |
|---|---|
| Идентификатор модели | gemini-4-hydrogen |
| Ввод | Текст, изображения, аудио, видео и поддерживаемые документы |
| Вывод | Текст, со структурированными частями вызовов функций при инструментах |
| Единый бюджет контекста | 1 048 576 токенов на ввод и вывод |
| Один сегмент основного вывода | До 65 536 токенов, включая рассуждение и вызовы функций |
| Возможности для приложений | Управление уровнем «мышления», структурированный вывод, вызов функций |
Это возможности модели, а не гарантия, что каждый шлюз предоставляет все функции провайдера. Примеры ниже используют стандартные поля запроса и короткие ответы в «переднем плане».
Официальный API Google и CometAPI
Оба маршрута поддерживают запросы к Gemini, но используют разные конечные точки, учетные данные и системы биллинга. Используйте Google для специфичных возможностей провайдера; используйте CometAPI для унифицированного шлюза или если у вас уже есть совместимый клиент.
| Выбор | Google Gemini Developer API | Интеграция CometAPI с Gemini |
|---|---|---|
| Хост нативного API | generativelanguage.googleapis.com | api.cometapi.com |
| Ключ API в этом гайде | GEMINI_API_KEY | COMETAPI_KEY |
| Аккаунт и биллинг | Управляется через Google | Управляется через CometAPI |
| Лучший старт | Особенности Google и контроль аккаунта | Унифицированный доступ к моделям или совместимый клиент OpenAI |
Сохраняйте одинаковые подсказки и бюджет вывода при сравнении двух маршрутов, чтобы результаты было полезно сравнивать. Альтернативы на JavaScript и совместимые с OpenAI явно настроены под CometAPI.
Как пошагово использовать Gemini 4 Hydrogen API?
Шаг 1: Создайте ключ API
Для CometAPI создайте аккаунт и сгенерируйте ключ в консоли токенов API. Для прямого доступа Google создайте ключ Gemini API в Google AI Studio. Подтвердите доступ к модели и биллинг или доступную квоту у выбранного аккаунта.
Храните ключ безопасно. Ключ CometAPI не сможет аутентифицировать запрос к конечной точке Google, и ключ Google не сможет аутентифицировать запрос к CometAPI.
Установите ключ для выбранного маршрута в Bash; вам нужна только одна из этих переменных.
export COMETAPI_KEY="YOUR_COMETAPI_KEY"
# Or, for direct Google access:
export GEMINI_API_KEY="YOUR_GEMINI_API_KEY"
Установите соответствующий ключ в PowerShell на Windows.
$env:COMETAPI_KEY = "YOUR_COMETAPI_KEY"
# Or, for direct Google access:
$env:GEMINI_API_KEY = "YOUR_GEMINI_API_KEY"
Шаг 2: Отправьте первый запрос через cURL
Отправьте нативный текстовый запрос через CometAPI из терминала Bash.
curl "https://api.cometapi.com/v1beta/models/gemini-4-hydrogen:generateContent" \
-H "x-goog-api-key: $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-X POST \
-d '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "Explain how an AI coding agent works in five steps."
}
]
}
],
"generationConfig": {
"maxOutputTokens": 4096,
"thinkingConfig": {
"thinkingLevel": "MEDIUM"
}
}
}'
Либо отправьте тот же нативный запрос напрямую в Google с ключом Google API.
curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-4-hydrogen:generateContent" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H "Content-Type: "application/json" \
-X POST \
-d '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "Explain how an AI coding agent works in five steps."
}
]
}
],
"generationConfig": {
"maxOutputTokens": 4096,
"thinkingConfig": {
"thinkingLevel": "MEDIUM"
}
}
}'
После успешного запроса проверьте три поля: candidates[0].content.parts для видимого текста, finishReason для статуса завершения и usageMetadata для использования токенов. Исправьте ошибки аутентификации или запроса, прежде чем добавлять код приложения.
Шаг 3: Настройте Python‑клиент и отправьте запрос
Установите пакеты, используемые в примерах на Python.
python -m pip install requests openai
Сохраните этот помощник как hydrogen_client.py. Оставьте PROVIDER равным cometapi для CometAPI или установите его в google для прямого доступа через Gemini Developer API. Далее нативные примеры импортируют этот файл, поэтому они сохраняют выбранный маршрут.
Настройте выбранную конечную точку и определите переиспользуемые помощники запроса и текста.
import os
import requests
MODEL = "gemini-4-hydrogen"
PROVIDER = "cometapi" # Change to "google" for direct access.
ROUTES = {
"cometapi": ("https://api.cometapi.com", "COMETAPI_KEY"),
"google": ("https://generativelanguage.googleapis.com", "GEMINI_API_KEY"),
}
BASE_URL, KEY_NAME = ROUTES[PROVIDER]
API_KEY = os.environ[KEY_NAME]
URL = f"{BASE_URL}/v1beta/models/{MODEL}:generateContent"
def generate(payload):
response = requests.post(
URL,
headers={"x-goog-api-key": API_KEY},
json=payload,
timeout=120,
)
response.raise_for_status()
return response.json()
def visible_text(data):
candidates = data.get("candidates") or []
if not candidates:
raise ValueError("No candidate returned; inspect promptFeedback.")
candidate = candidates[0]
parts = candidate.get("content", {}).get("parts", [])
text = "".join(
part.get("text", "") for part in parts
if not part.get("thought", False)
)
if not text:
raise ValueError(
f"No visible text; inspect parts and finishReason: "
f"{candidate.get('finishReason')}"
)
return text
Сохраните следующее как hydrogen.py рядом с помощником. Он выводит ответ, причину завершения и использование, чтобы вы могли отличить завершенный ответ от ответа, остановившегося на лимите токенов.
Отправьте текстовый запрос с использованием настроенного провайдера.
from hydrogen_client import generate, visible_text
data = generate({
"contents": [{"role": "user", "parts": [{
"text": "Explain API rate limiting in three sentences."
}]}],
"generationConfig": {
"maxOutputTokens": 4096,
"thinkingConfig": {"thinkingLevel": "MEDIUM"},
},
})
print(visible_text(data))
candidate = data["candidates"][0]
print("Finish reason:", candidate.get("finishReason"))
print("Usage:", data.get("usageMetadata", {}))
Запустите скрипт в том терминале, где вы установили выбранный ключ API.
python hydrogen.py
Прочитайте ответ, затем проверьте finishReason, чтобы понять, почему генерация остановилась. В usageMetadata проверьте, сколько токенов использовал запрос. MAX_TOKENS означает, что ответ может быть неполным, даже если HTTP‑запрос успешен.
Используйте JavaScript или клиент, совместимый с OpenAI
Выберите пример, соответствующий вашему приложению. Пример на Node.js отправляет нативный запрос Gemini. Если вы уже используете SDK OpenAI, перейдите к примеру на Python ниже.
JavaScript с Node.js
Сохраните следующее как hydrogen.js и выполните node hydrogen.js. Он отправляет тот же нативный формат запроса и извлекает все видимые текстовые части.
Отправьте нативный запрос GenerateContent из Node.js.
const apiKey = process.env.COMETAPI_KEY;
if (!apiKey) throw new Error("Set COMETAPI_KEY before running this script.");
const baseUrl = "https://api.cometapi.com";
const model = "gemini-4-hydrogen";
async function main() {
const response = await fetch(
`${baseUrl}/v1beta/models/${model}:generateContent`,
{
method: "POST",
headers: {
"Content-Type": "application/json",
"x-goog-api-key": apiKey
},
body: JSON.stringify({
contents: [
{
role: "user",
parts: [
{
text: "Explain how an AI coding agent works."
}
]
}
],
generationConfig: {
maxOutputTokens: 4096,
thinkingConfig: {
thinkingLevel: "MEDIUM"
}
}
})
}
);
if (!response.ok) {
throw new Error(
`API error: ${response.status} ${await response.text()}`
);
}
const data = await response.json();
const candidate = data.candidates?.[0];
const text = (candidate?.content?.parts || [])
.filter(part => !part.thought)
.map(part => part.text || "")
.join("");
if (!text) {
throw new Error(`No visible text; finishReason=${candidate?.finishReason}`);
}
console.log(text);
}
main().catch(console.error);
Python с SDK OpenAI
Если ваше приложение уже использует SDK OpenAI, CometAPI также предоставляет POST /v1/chat/completions. Самая простая миграция — изменить ключ API, базовый URL и идентификатор модели. Используйте этот маршрут для распространенных чат‑сценариев; используйте нативную конечную точку Gemini, когда вам нужны специфичные поля Gemini.
Создайте запрос Chat Completions через CometAPI.
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["COMETAPI_KEY"],
base_url="https://api.cometapi.com/v1"
)
response = client.chat.completions.create(
model="gemini-4-hydrogen",
messages=[
{
"role": "user",
"content": "Explain how an AI coding agent works."
}
]
)
print(response.choices[0].message.content)
Нативные примеры используют contents и generationConfig; Chat Completions использует messages и собственные поля запроса. Держите каждый запрос в одном формате, вместо попытки копировать нативные поля в вызов SDK, который их не принимает.
Расширенные возможности Gemini 4 Hydrogen API
Следующие примеры повторно используют hydrogen_client.py из раздела настройки, поэтому они работают с провайдером, выбранным в PROVIDER. Пример стриминга ниже использует отдельный клиент CometAPI Chat Completions, который подходит существующему приложению, совместимому с OpenAI.
Настройте рассуждение и структурированный вывод
Используйте generationConfig, чтобы задать thinkingConfig.thinkingLevel в значения LOW, MEDIUM, HIGH или XHIGH. Выберите бюджет вывода, оставляющий место и для рассуждений, и для видимого ответа. Когда приложению нужен JSON, используйте responseMimeType и responseSchema, а не полагайтесь только на просьбу о форматировании на естественном языке.
Задайте бюджет вывода и уровень рассуждений для нативного запроса.
{
"generationConfig": {
"maxOutputTokens": 4096,
"thinkingConfig": {"thinkingLevel": "MEDIUM"}
}
}
Транслируйте ответы через CometAPI
Стриминг возвращает сгенерированный контент по частям, вместо ожидания полного ответа. Это полезно для чат‑интерфейсов, ассистентов программирования и приложений, где важна воспринимаемая задержка.
CometAPI документирует потоковые Chat Completions с stream=true. Пример на Python обрабатывает чанки без choices, что может встречаться в потоковых ответах.
Печатайте текст по мере поступления через конечную точку, совместимую с OpenAI.
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["COMETAPI_KEY"],
base_url="https://api.cometapi.com/v1"
)
stream = client.chat.completions.create(
model="gemini-4-hydrogen",
messages=[
{
"role": "user",
"content": (
"Write a Python function that validates an email "
"address and explain the main checks."
)
}
],
stream=True
)
for chunk in stream:
if not chunk.choices:
continue
delta = chunk.choices[0].delta
if delta and delta.content:
print(delta.content, end="", flush=True)
print()
Для нативного клиента CometAPI документирует streamGenerateContent с Server‑Sent Events. Этот маршрут возвращает объекты ответа GenerateContent, а не дельты Chat Completions. Держите парсер в соответствии с маршрутом; поведение стриминга может различаться между нативной конечной точкой Gemini и шлюзом, совместимым с OpenAI. Протестируйте конкретный маршрут Hydrogen, используемый вашим приложением, прежде чем переносить существующий стриминговый клиент.
Сохраняйте историю многошагового диалога
Отправляйте предыдущие реплики пользователя и модели со следующим запросом. Сохраняйте полный объект контента модели вместо пересборки по видимому тексту — так вы сохраните возвращенные метаданные для следующего шага. Сохраните пример как hydrogen_history.py рядом с общим помощником.
Сделайте два связанных запроса, сохранив полный первый ответ модели.
from hydrogen_client import generate, visible_text
history = [{"role": "user", "parts": [{
"text": "Suggest a simple queue-based background job architecture."
}]}]
config = {
"maxOutputTokens": 4096,
"thinkingConfig": {"thinkingLevel": "MEDIUM"},
}
first = generate({"contents": history, "generationConfig": config})
print(visible_text(first))
candidate = first["candidates"][0]
if candidate.get("finishReason") != "STOP":
raise RuntimeError("The first turn did not finish normally.")
history.append(candidate["content"])
history.append({"role": "user", "parts": [{
"text": "Now identify three failure scenarios in that design."
}]})
second = generate({"contents": history, "generationConfig": config})
print(visible_text(second))
print("Finish reason:", second["candidates"][0].get("finishReason"))
Выполните python hydrogen_history.py. Второй ответ должен опираться на дизайн из первого шага. В этом примере сохраняйте ранний префикс диалога неизменным; для долгоживущих приложений потребуется отдельная политика по сжатию и лимитам контекста.
Отправляйте изображения и PDF
Hydrogen поддерживает понимание изображений и документов. В нативном формате запроса Gemini добавьте часть inlineData рядом с текстовой инструкцией. Это полезно для анализа скриншотов, диаграмм архитектуры, сканированных форм и извлечения отчетов.
Сохраните этот пример как analyze_file.py рядом с hydrogen_client.py. Он отправляет один локальный файл изображения или PDF, чтобы вы могли использовать один и тот же код для обоих типов. Для первого запроса используйте небольшой файл; Base64 увеличивает размер запроса.
Проанализируйте локальный PNG, JPEG или PDF с использованием общего нативного клиента.
import base64
import sys
from pathlib import Path
from hydrogen_client import generate, visible_text
path = Path(sys.argv[1])
mime_types = {
".png": "image/png", ".jpg": "image/jpeg",
".jpeg": "image/jpeg", ".pdf": "application/pdf",
}
mime_type = mime_types.get(path.suffix.lower())
if mime_type is None:
raise ValueError("Choose a PNG, JPEG, or PDF file.")
data = generate({
"contents": [{"role": "user", "parts": [
{"text": "Summarize this file and identify the key findings."},
{"inlineData": {
"mimeType": mime_type,
"data": base64.b64encode(path.read_bytes()).decode("ascii"),
}},
]}],
"generationConfig": {"maxOutputTokens": 4096},
})
print(visible_text(data))
Запустите пример с вашим документом или изображением.
python analyze_file.py report.pdf
python analyze_file.py diagram.png
Байты файла должны соответствовать указанному MIME‑типу. Переименование расширения не конвертирует файл. Если загрузка отклонена, изучите ошибку на предмет ограничения размера или формата, прежде чем повторять; не предполагается, что URI файла, размещенного Google, доступен через сторонний шлюз.
Подключите управляемые приложением инструменты
Вызов функций позволяет модели запросить операцию, которую выполняет ваше приложение. Модель возвращает структурированный вызов функции; ваше приложение валидирует аргументы, исполняет функцию и отправляет результат обратно.
Этот пример использует небольшую фиктивную базу заказов. Сохраните его как order_agent.py рядом с общим клиентом. Он реализует круговой обмен, ограничивает цикл четырьмя запросами и сохраняет полный контент модели — включая любые возвращенные сигнатуры — между шагами.
Запустите ограниченный цикл вызова функций на локальной демонстрационной базе.
from hydrogen_client import generate, visible_text
orders = {"DEMO-1001": {"status": "shipped", "carrier": "Example Carrier"}}
tools = [{"functionDeclarations": [{
"name": "lookup_order",
"description": "Retrieve a demonstration order by its order ID.",
"parameters": {
"type": "OBJECT",
"properties": {"order_id": {"type": "STRING"}},
"required": ["order_id"],
},
}]}]
history = [{"role": "user", "parts": [{
"text": "Use lookup_order to check the status of DEMO-1001."
}]}]
for _ in range(4):
data = generate({
"contents": history,
"tools": tools,
"generationConfig": {"maxOutputTokens": 4096},
})
candidates = data.get("candidates") or []
if not candidates or not candidates[0].get("content"):
raise RuntimeError("No model content returned.")
model_content = candidates[0]["content"]
calls = [
part["functionCall"] for part in model_content.get("parts", [])
if "functionCall" in part
]
if not calls:
print(visible_text(data))
break
history.append(model_content) # Preserve all parts and signatures.
results = []
for call in calls:
args = call.get("args", {})
order_id = args.get("order_id") if isinstance(args, dict) else None
if call.get("name") != "lookup_order":
raise ValueError("Unexpected function name.")
if not isinstance(order_id, str) or not order_id:
raise ValueError("order_id must be a non-empty string.")
result = orders.get(order_id, {"error": "Order not found"})
reply = {"name": call["name"], "response": result}
if "id" in call:
reply["id"] = call["id"]
results.append({"functionResponse": reply})
history.append({"role": "user", "parts": results})
else:
raise RuntimeError("Tool-call limit reached before a final answer.")
Выполните python order_agent.py. Финальный ответ должен соответствовать локальной записи для DEMO-1001. В реальном сервисе авторизуйте пользователя перед доступом к заказу; выбор идентификатора заказа моделью не является доказательством разрешения.
Сколько стоит Gemini 4 Hydrogen API?
Цены ниже указаны в долларах США за миллион токенов, проверены 17 ноября 2026 года. Сравниваются стандартные не кэшированные вход и выход, без учета пакетной обработки, приоритета, кэшированного ввода или отдельно тарифицируемых инструментов.
| Тип токенов | Глобальные стандартные тарифы Google | Gemini 4 Hydrogen API в CometAPI |
|---|---|---|
| Входные токены / 1M | $1.50 | $1.20 |
| Выходные токены / 1M | $7.50 | $6.00 |
Для 100 000 входных токенов и 10 000 тарифицируемых выходных токенов оценка CometAPI составляет 0.1 × $1.20 + 0.01 × $6.00 = $0.18. Те же объемы по указанным стандартным ставкам Google стоят $0.225, разница 20%. Учитывайте токены рассуждения в выходном использовании и проверяйте списание по вашему аккаунту при оценке реального процесса.
Как мигрировать на Gemini 4 Hydrogen API?
Что меняется при миграции с Gemini 3.8 Flash?
Прежде чем менять идентификатор модели, проверьте настройку рассуждений, бюджет контекста и историю диалога, которую ваш клиент отправляет с каждым запросом.
| Деталь интеграции | Gemini 3.8 Flash | Gemini 4 Hydrogen |
|---|---|---|
| Уровень рассуждения по умолчанию | MEDIUM | HIGH |
| Учёт контекста | Раздельные лимиты на ввод и вывод | Один общий бюджет на ввод/вывод |
| Состояние в несколько шагов | Проверьте обработку истории текущим клиентом | Сохраняйте полные части и сигнатуры модели; правки префикса требуют спец. обработки |
Документированные изменения миграции особенно важны, если ваше приложение полагается на значения по умолчанию, сжимает историю или выполняет несколько шагов с инструментами. Явно задайте уровень рассуждения и протестируйте короткий существующий процесс до смены модели в продакшене.
Обновите существующую интеграцию
Создайте тестовую конфигурацию с новым идентификатором модели, сохранив ключ и конечную точку вместе. Запустите тот же репрезентативный рабочий процесс с обеими конфигурациями, чтобы сравнить их поведение.
- Отправьте новый текстовый запрос и проверьте причину завершения и использование токенов.
- Повторите многошаговую задачу и цикл с инструментом, используя полные объекты ответа модели.
- Удалите несовместимые настройки, перечисленные в разделе ограничений, прежде чем сравнивать результаты запросов.
- Проверьте откат в новой беседе; не предполагайте, что другая модель примет сохраненные метаданные рассуждения Hydrogen.
Решите, улучшит ли миграция ваш рабочий процесс
Примите новую конфигурацию, когда она достигает целевых показателей качества и задержки при приемлемой цене за завершенную задачу. Если текущий клиент уже достигает этих целей, проведите ограниченный пилот, чтобы подтвердить пользу, прежде чем переводить все запросы. Сохраняйте подсказки, входные данные и критерии оценки неизменными во время сравнения.
Ограничения Gemini 4 Hydrogen API
Руководство разработчика Hydrogen описывает ограничения, влияющие на существующие клиенты. Учитывайте их при построении запроса, а не повторяйте тот же отклоненный payload.
- Неподдерживаемые поля: удалите thinkingBudget, thinkingLevel со значением MINIMAL, frequencyPenalty, presencePenalty и candidateCount больше единицы.
- Игнорируемые настройки сэмплинга: кастомные temperature, topP и topK не управляют выводом Hydrogen.
- Кэширование: явный cachedContent не поддерживается. Стабильные префиксы подсказок могут использовать неявное кэширование, но это не дает скидку кэша, зависящую от шлюза.
- Длинный вывод: образец клиента в этом руководстве реализует только синхронный запрос. Он не покрывает фоновую длительную декодировку или специфичные для провайдера схемы продолжения.
- Изменения диалога: модификация ранних подсказок или определений инструментов может инвалидировать состояние рассуждения. Сохраняйте префикс или реализуйте документированную обработку несовпадения префикса для выбранного маршрута.
Типовые проверки настройки
| Симптом | Первичная проверка |
|---|---|
| 401 или 403 | Убедитесь, что учетные данные соответствуют конечной точке и имеют доступ к выбранной модели. |
| 400 | Прочтите тело ошибки; проверьте неподдерживаемые поля, некорректный JSON и метаданные диалога. |
| Нет видимого текста | Проверьте promptFeedback, части кандидата и finishReason; ответ мог быть заблокирован, неполным или запрашивать инструмент. |
| MAX_TOKENS | Считайте текст потенциально неполным и пересмотрите бюджет вывода, прежде чем принимать его. |
| Запрос с файлом отклонен | Проверьте фактический MIME‑тип и лимит payload для выбранного маршрута. |
При неожиданных сбоях фиксируйте модель, маршрут, статус, метку времени и идентификатор запроса, если доступен. Не записывайте в обычные логи ключи API и чувствительное содержимое файлов.
Вопросы и ответы
Как повторять попытки при ошибках лимитов скорости Gemini 4 Hydrogen API?
Для HTTP 429 снизьте параллелизм и повторяйте попытку с экспоненциальной паузой и джиттером, с фиксированным максимальным числом попыток. Сохраняйте идентификатор запроса, когда шлюз его предоставляет. Не повторяйте без изменений некорректные запросы или ошибки аутентификации; руководство CometAPI по ошибкам и стратегии ретраев отличает их от временных сбоев. Таймаут может произойти после начала обработки, поэтому защитите любую сторону приложения от дублирующего выполнения.
Можно ли вызывать Gemini 4 Hydrogen API напрямую из веб‑приложения?
Проксируйте запросы через ваш бекенд. Ключ, встроенный во фронтенд‑JavaScript, может быть извлечен посетителями, даже если код собран или минифицирован. Пусть бекенд аутентифицирует пользователей, применяет лимиты использования и отправляет запрос модели. Для стриминга проксируйте инкрементальный ответ в браузер, не раскрывая исходный ключ API.
Как обрабатывать прерванный поток Gemini 4 Hydrogen?
Считайте полученный текст частичным результатом до завершения ответа. Новый запрос запускает новую генерацию; он не возобновляет автоматически прерванный поток с того же токена. Держите частичный вывод отдельно от повторного ответа и не выполняйте действия по неполному JSON или незавершенным аргументам инструмента. Предложите пользователю явное действие «Повторить», а не незаметно склеивайте две генерации.
Заключение
Используйте репрезентативную задачу как первый критерий приемки: запрос должен выполниться, приложение должно извлечь нужный результат, а зафиксированное потребление токенов — соответствовать вашему бюджету. Добавляйте по одной функции за раз и держите эту проверку в наборе интеграционных тестов. Небольшой, наблюдаемый клиент проще расширять, чем крупный рабочий процесс с трудноотслеживаемыми сбоями.

