Перейти к содержанию

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

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

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

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

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

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. При работе через хаб действуют следующие отличия:

  • Этот адрес 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.

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

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

МетодПутьНазначение и справочник
POST/v1beta/interactions, /v1/interactionsСоздание взаимодействия
GET/v1beta/interactions/{id}, /v1/interactions/{id}Получение взаимодействия
DELETE/v1beta/interactions/{id}, /v1/interactions/{id}Удаление взаимодействия
POST/v1beta/interactions/{id}/cancel, /v1/interactions/{id}/cancelОтмена взаимодействия

Отдельного GET /models у этого адреса API нет: выбирайте идентификатор модели в каталоге моделей; цены приведены на странице «Тарифы».

Ошибки​

Некорректный или неизвестный идентификатор взаимодействия возвращает ошибку со статус-кодом 404 и code: "not_found". Формат и примеры ошибок приведены в справочнике Google API, а общие ошибки авторизации, баланса и лимитов расходов — в общем справочнике API и на странице «Лимиты и ограничения».