Skip to main content

Co zbudujesz

Wyślesz natywne żądanie Gemini POST /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:
Użyj x-goog-api-key dla bezpośrednich natywnych żądań Gemini HTTP:
Używaj bazowego URL zgodnego z OpenAI tylko wtedy, gdy Twoja aplikacja już korzysta z Chat Completions:

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

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.
Wysyłaj żądania contents, parts, generationConfig i streamGenerateContent do natywnego endpointu Gemini. Ścieżka zgodna z OpenAI oczekuje messages i parametrów Chat Completions.
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.
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