POST interactions — Google
POST /google/api/v1beta/interactions и POST /google/api/v1/interactions создают interaction с помощью Gemini; другие генеративные модели доступны с конвертацией. Поля описаны в документации Google Interactions.
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. Фрагмент ответа:
{"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: операции чтения, удаления и отмены поддерживаются только для взаимодействий 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 модели. При конвертации учитывается работа в протоколе модели. Правила расчета, кэша и завершения прерванных запросов — на странице «Стоимость генеративных моделей», цены — на «Тарифах». Для прямого вызова 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; общие ошибки ключа, выбора модели и баланса описаны в общем справочнике, ограничения — в разделе «Лимиты и ограничения».
