# Google-совместимый API

Настройка клиента Google Interactions для работы через CoreInfra AI Hub, отличия и правила конвертации.

Google-совместимый API хаба позволяет вызывать модели Gemini и другие генеративные модели через хаб без VPN по протоколу Google Interactions с оплатой по ключу хаба.

## 1. Настройте адрес и ключ

Укажите базовый адрес `https://hub.coreinfra.ai/google/api` (поддерживаются пути `/v1beta/...` и `/v1/...`) и подставьте ключ хаба `sk-ci2-...` в заголовок `x-goog-api-key` или `Authorization: Bearer`.

Проверьте запрос через cURL:

```bash
export COREINFRA_API_KEY='sk-ci2-...'
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.8-flash","input":"2 + 2"}'
```

Ожидаемый текст ответа — `4`.

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

Полное описание формата приведено в [документации Google Interactions](https://ai.google.dev/api/interactions-api). При работе через хаб действуют следующие отличия:

* Этот адрес API обслуживает Interactions. Пути `generateContent`, `streamGenerateContent`, Files и управление кэшами через него не предоставляются.
* Не поддерживаются `background: true`, поле `agent` (указывайте `model`), входные аудио и видео, `cached_content` и встроенный инструмент `file_search` (возвращается ошибка со статус-кодом `400`).
* Изображения и документы во входе передавайте в кодировке base64. Ссылки на внешние ресурсы и идентификаторы файлов в Files API отклоняются со статус-кодом `400`.
* Сохраненные взаимодействия (`interactions/{id}`) не изолированы по ключам хаба: любой действительный ключ, знающий идентификатор, может обратиться к ресурсу. Обращайтесь с идентификатором как с секретом.

## Конвертация

Когда в запросе указана генеративная модель другого провайдера (например, OpenAI, Anthropic, DeepSeek, Z.ai или Moonshot AI), хаб конвертирует запрос на своей стороне и возвращает ответ в формате Google Interactions:

* При конвертации не поддерживаются `previous_interaction_id` и `cached_content` (возвращается ошибка со статус-кодом `400` — передавайте историю сообщений в `input`).
* Конвертируются только текстовые ответы и пользовательские инструменты `function`; встроенные инструменты Google, `generation_config.tool_choice: "validated"` и нетекстовые `response_modalities` не конвертируются. Подробности приведены в [справочнике Google API](https://coreinfra.ru/docs/reference/google.md).

## Что доступно

Доступны следующие API методы относительно `https://hub.coreinfra.ai/google/api`:

| Метод    | Путь                                                               | Назначение и справочник                                                                      |
| -------- | ------------------------------------------------------------------ | -------------------------------------------------------------------------------------------- |
| `POST`   | `/v1beta/interactions`, `/v1/interactions`                         | [Создание взаимодействия](https://coreinfra.ru/docs/reference/google/interactions.md)        |
| `GET`    | `/v1beta/interactions/{id}`, `/v1/interactions/{id}`               | [Получение взаимодействия](https://coreinfra.ru/docs/reference/google/interactions-get.md)   |
| `DELETE` | `/v1beta/interactions/{id}`, `/v1/interactions/{id}`               | [Удаление взаимодействия](https://coreinfra.ru/docs/reference/google/interactions-delete.md) |
| `POST`   | `/v1beta/interactions/{id}/cancel`, `/v1/interactions/{id}/cancel` | [Отмена взаимодействия](https://coreinfra.ru/docs/reference/google/interactions-cancel.md)   |

Отдельного `GET /models` у этого адреса API нет: выбирайте идентификатор модели в [каталоге моделей](https://coreinfra.ru/docs/catalog.md); цены приведены на странице [«Тарифы»](https://hub.coreinfra.ai/pricing).

## Ошибки

Некорректный или неизвестный идентификатор взаимодействия возвращает ошибку со статус-кодом `404` и `code: "not_found"`. Формат и примеры ошибок приведены в [справочнике Google API](https://coreinfra.ru/docs/reference/google.md#errors), а общие ошибки авторизации, баланса и лимитов расходов — в [общем справочнике API](https://coreinfra.ru/docs/reference.md#errors) и на странице [«Лимиты и ограничения»](https://coreinfra.ru/docs/limits.md).
