Co zbudujesz
Wyślesz natywne żądanie GeminiPOST /v1beta/models/\{model\}:generateContent, a następnie porównasz je z opcją zgodną z OpenAI POST /v1/chat/completions dla aplikacji, które już używają formatów żądań Chat Completions.
Wymagania wstępne
- Klucz API CometAPI zapisany w
COMETAPI_KEY - model ID tekstowego modelu Gemini ze strony Models page
curl, Python 3.10+ lub Node.js 18+
Klucz API, bazowy URL, uwierzytelnianie
Użyj natywnego endpointu Gemini, jeśli chcesz korzystać z pól żądań Gemini:x-goog-api-key dla bezpośrednich natywnych żądań Gemini HTTP:
Natywny format Gemini
Natywne żądania Gemini używającontents, parts i generationConfig. Wybierz tę ścieżkę, jeśli potrzebujesz pól specyficznych dla Gemini, takich jak kontrola myślenia, części multimedialne, Google Search grounding lub natywne operatory Streaming.
Opcja zgodna z OpenAI
Użyj ścieżki zgodnej z OpenAI, gdy migrujesz istniejący OpenAI SDK lub aplikację Chat Completions i nie potrzebujesz natywnych pól żądań Gemini.Wyjaśnienie przepływu
Nie mieszaj tych dwóch formatów żądań. Natywne pola Gemini, takie jak
contents i generationConfig, należą do ścieżki generateContent. Pola Chat Completions, takie jak messages, należą do ścieżki zgodnej z OpenAI.
Rozwiązywanie problemów / FAQ
Od której ścieżki powinienem zacząć
Od której ścieżki powinienem zacząć
Zacznij od natywnego Gemini
generateContent, jeśli tworzysz nowy workflow Gemini. Użyj ścieżki zgodnej z OpenAI, gdy istniejąca aplikacja już zależy od OpenAI SDK lub formatów żądań Chat Completions.Natywne pola Gemini nie działają w Chat Completions
Natywne pola Gemini nie działają w Chat Completions
Wysyłaj żądania
contents, parts, generationConfig i streamGenerateContent do natywnego endpointu Gemini. Ścieżka zgodna z OpenAI oczekuje messages i parametrów Chat Completions.model ID Gemini nie działa
model ID Gemini nie działa
Potwierdź, że model ID jest dostępny dla Twojego konta i obsługuje ścieżkę, którą wywołujesz. Użyj strony Models page, aby znaleźć aktualne model IDs.
SDK wskazuje na niewłaściwą usługę
SDK wskazuje na niewłaściwą usługę
Dla żądań Google GenAI SDK ustaw bazowy URL na
https://api.cometapi.com. Dla żądań OpenAI SDK ustaw base_url w Pythonie lub baseURL w Node.js na https://api.cometapi.com/v1.Kolejne kroki
- Użyj referencji natywnego API Gemini, aby poznać pełne pola żądania i odpowiedzi
generateContent. - Przeczytaj referencję API Chat Completions, aby poznać format żądania zgodny z OpenAI.
- Skonfiguruj klientów OpenAI SDK w Use CometAPI with OpenAI SDKs.
- Wyświetl dostępne modele za pomocą List available CometAPI models.
- Dodaj obsługę ponowień i limitów szybkości za pomocą Error codes and retry strategy.