Skip to main content

Що ви побудуєте

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

Передумови

  • Ключ API CometAPI, збережений у COMETAPI_KEY
  • model ID текстової моделі Gemini зі сторінки Models
  • curl, Python 3.10+ або Node.js 18+

Ключ API, base URL, автентифікація

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

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

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

OpenAI-сумісний варіант

Використовуйте OpenAI-сумісний маршрут, коли ви мігруєте наявний застосунок на OpenAI SDK або Chat Completions і вам не потрібні нативні поля запиту Gemini.

Пояснення потоку

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

Усунення проблем / FAQ

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

Наступні кроки