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 и на странице «Лимиты и ограничения».
