# POST interactions — Google

Ограничения Google Interactions, преобразование полей и учет usage в хабе.

`POST /google/api/v1beta/interactions` и `POST /google/api/v1/interactions` создают interaction с помощью Gemini; другие генеративные модели доступны с конвертацией. Поля описаны в [документации Google Interactions](https://aistudio.google.com/api-reference/interactions-api/create-interaction).

```bash
curl https://hub.coreinfra.ai/google/api/v1beta/interactions \
  -H "x-goog-api-key: $COREINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"gemini-3.1-flash-lite","input":"2 + 2"}'
```

Ожидаемый текст — `4`. Фрагмент ответа:

```json
{"steps":[{"type":"model_output","content":[{"type":"text","text":"4"}]}]}
```

## Отличия от API Google

### Поддерживаемые возможности

Ключ хаба передается в `x-goog-api-key` или `Authorization: Bearer`. Параметр URL `key` не используется для авторизации. Обе версии пути обслуживаются одинаково; версия входного пути не выбирает отдельный режим обработки.

При прямом вызове Gemini со статус-кодом `400` отклоняются `agent`, `background: true`, `cached_content`, инструмент `file_search`, входные аудио и видео. Проверяются и медиа внутри результатов функций. Используйте `model` и синхронное выполнение.

Изображения и документы должны быть встроены в запрос в кодировке base64. Ссылки Files API и ссылки на внешние ресурсы в `uri` отклоняются со статус-кодом `400`; у документа отклоняется любое непустое `uri`, у изображения допускается `data:image/...;base64,...`. При `stream: true` возвращается SSE; отдельно добавлять `alt=sse` к адресу хаба не требуется.

Выбранный `service_tier` учитывается при расчете стоимости; если для модели нет выбранного уровня обслуживания, возвращается ошибка со статус-кодом `400`.

### При конвертации

Когда выбрана генеративная модель другого провайдера, хаб конвертирует запрос и возвращает ответ в формате Interactions. Сгенерированный `id` такого ответа не создает сохраненный ресурс Google: операции [чтения](https://coreinfra.ru/docs/reference/google/interactions-get.md), [удаления](https://coreinfra.ru/docs/reference/google/interactions-delete.md) и [отмены](https://coreinfra.ru/docs/reference/google/interactions-cancel.md) поддерживаются только для взаимодействий Gemini.

* Поля `previous_interaction_id`, `cached_content` и `agent` отклоняются со статус-кодом `400`.
* Из `response_modalities` конвертируется только текст, а из инструментов — только пользовательские функции `function`. Не конвертируются `background`, `generation_config.tool_choice: "validated"`, `resolution` у изображений и `annotations` у текста.
* При конвертации в OpenAI Responses не конвертируются `generation_config.stop_sequences` и `generation_config.seed`, а лимит выхода ниже `16` повышается до `16`.
* При конвертации в Anthropic Messages без заданного `generation_config.max_output_tokens` используется `max_tokens: 16000` (или `64000` для потока), а `seed` не конвертируется.
* Настройка рассуждений игнорируется у моделей без ее поддержки.

### Оплата

Перед отправкой хаб резервирует средства по оценке запроса, после ответа рассчитывает стоимость по `usage` модели. При конвертации учитывается работа в протоколе модели. Правила расчета, кэша и завершения прерванных запросов — на странице [«Стоимость генеративных моделей»](https://coreinfra.ru/docs/billing/text.md), цены — на [«Тарифах»](https://hub.coreinfra.ai/pricing). Для прямого вызова Gemini вход включает `total_input_tokens` и `total_tool_use_tokens`, из него вычитается кэш `total_cached_tokens`. Выход включает `total_output_tokens` и `total_thought_tokens`. Вызовы `google_search` и `google_maps` из `grounding_tool_count` учитываются как отдельные запросы веб-поиска.

## Ошибки

* `400` — запрещенные возможности, неподходящее вложение, неподдерживаемый `service_tier` или запрос невозможно преобразовать.
* `502` — ошибка на стороне провайдера модели при выполнении запроса. После начала SSE ошибка передается событием потока.

Формат ошибок приведен в [разделе Google API](https://coreinfra.ru/docs/reference/google.md#errors); общие ошибки ключа, выбора модели и баланса описаны в [общем справочнике](https://coreinfra.ru/docs/reference.md#errors), ограничения — в разделе [«Лимиты и ограничения»](https://coreinfra.ru/docs/limits.md).
