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

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; общие ошибки ключа, выбора модели и баланса описаны в общем справочнике, ограничения — в разделе «Лимиты и ограничения».