Що ви побудуєте
Ви надішлете нативний запит GeminiPOST /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:
Нативний формат 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.Нативні поля Gemini не працюють у Chat Completions
Нативні поля Gemini не працюють у Chat Completions
Надсилайте запити
contents, parts, generationConfig і streamGenerateContent до нативного endpoint Gemini. OpenAI-сумісний маршрут очікує messages і параметри Chat Completions.model ID Gemini не працює
model ID Gemini не працює
Підтвердьте, що model ID доступний для вашого облікового запису та підтримує маршрут, який ви викликаєте. Використовуйте сторінку Models, щоб знайти поточні model IDs.
SDK вказує на неправильний сервіс
SDK вказує на неправильний сервіс
Для запитів Google GenAI SDK встановіть base URL як
https://api.cometapi.com. Для запитів OpenAI SDK встановіть base_url у Python або baseURL у Node.js як https://api.cometapi.com/v1.Наступні кроки
- Використовуйте довідник Gemini native API для повних полів запиту та відповіді
generateContent. - Прочитайте довідник Chat Completions API для OpenAI-сумісної форми запиту.
- Налаштуйте клієнти OpenAI SDK у Використання CometAPI з OpenAI SDKs.
- Перелічіть доступні моделі за допомогою Перелік доступних моделей CometAPI.
- Додайте обробку retry та rate-limit за допомогою Коди помилок і стратегія retry.