Skip to main content

Что вы создадите

Вы отправите нативный запрос Gemini POST /v1beta/models/\{model\}:generateContent, а затем сравните его с OpenAI-compatible вариантом POST /v1/chat/completions для приложений, которые уже используют формат запросов Chat Completions.

Предварительные требования

  • Ключ API CometAPI, сохранённый в COMETAPI_KEY
  • model ID текстовой модели Gemini со страницы Models page
  • curl, Python 3.10+ или Node.js 18+

API key, base URL, аутентификация

Используйте нативный endpoint Gemini, если вам нужны поля запросов Gemini:
Используйте x-goog-api-key для прямых нативных Gemini HTTP-запросов:
Используйте OpenAI-compatible base URL только в том случае, если ваше приложение уже использует Chat Completions:

Нативный формат Gemini

Нативные запросы Gemini используют contents, parts и generationConfig. Используйте этот путь, если вам нужны специфичные для Gemini поля, такие как элементы управления thinking, медиа-части, grounding через Google Search или нативные операторы streaming.

OpenAI-compatible вариант

Используйте OpenAI-compatible маршрут, если вы переносите существующее приложение на OpenAI SDK или Chat Completions и вам не нужны нативные поля запросов Gemini.

Объяснение потока

Не смешивайте эти два формата запросов. Нативные поля Gemini, такие как contents и generationConfig, относятся к маршруту generateContent. Поля Chat Completions, такие как messages, относятся к OpenAI-compatible маршруту.

Устранение неполадок / FAQ

Начинайте с нативного Gemini generateContent, если вы создаёте новый workflow для Gemini. Используйте OpenAI-compatible маршрут, если существующее приложение уже зависит от OpenAI SDK или форматов запросов Chat Completions.
Отправляйте запросы contents, parts, generationConfig и streamGenerateContent в нативный endpoint Gemini. OpenAI-compatible маршрут ожидает messages и параметры Chat Completions.
Убедитесь, что этот model ID доступен вашей учётной записи и поддерживает вызываемый вами маршрут. Используйте страницу Models page, чтобы найти актуальные model ID.
Для запросов через Google GenAI SDK установите base URL в https://api.cometapi.com. Для запросов через OpenAI SDK установите base_url в Python или baseURL в Node.js в значение https://api.cometapi.com/v1.

Следующие шаги