Что вы создадите
Вы отправите нативный запрос GeminiPOST /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-запросов:
Нативный формат 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.Нативные поля Gemini не работают в Chat Completions
Нативные поля Gemini не работают в Chat Completions
Отправляйте запросы
contents, parts, generationConfig и streamGenerateContent в нативный endpoint Gemini. OpenAI-compatible маршрут ожидает messages и параметры Chat Completions.model ID Gemini не работает
model ID Gemini не работает
Убедитесь, что этот model ID доступен вашей учётной записи и поддерживает вызываемый вами маршрут. Используйте страницу Models page, чтобы найти актуальные model ID.
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 reference для полного описания полей запроса и ответа
generateContent. - Прочитайте Chat Completions API reference, чтобы узнать формат OpenAI-compatible запроса.
- Настройте клиенты OpenAI SDK в Use CometAPI with OpenAI SDKs.
- Получите список доступных моделей с помощью List available CometAPI models.
- Добавьте обработку повторных попыток и ограничений скорости с помощью Error codes and retry strategy.