Was Sie erstellen werden
Sie senden einen nativen Gemini-Request anPOST /v1beta/models/\{model\}:generateContent und vergleichen ihn anschließend mit der OpenAI-kompatiblen Option POST /v1/chat/completions für Apps, die bereits Chat Completions-Request-Formate verwenden.
Voraussetzungen
- Ein in
COMETAPI_KEYgespeicherter CometAPI-API-Schlüssel - Eine Gemini-Textmodell-ID von der Modellseite
curl, Python 3.10+ oder Node.js 18+
API-Schlüssel, base URL, Authentifizierung
Verwenden Sie den nativen Gemini-Endpunkt, wenn Sie Gemini-Request-Felder verwenden möchten:x-goog-api-key für direkte native Gemini-HTTP-Requests:
Natives Gemini-Format
Native Gemini-Requests verwendencontents, parts und generationConfig. Verwenden Sie diesen Pfad, wenn Sie Gemini-spezifische Felder wie Thinking-Steuerungen, Medienteile, Google Search Grounding oder native Streaming-Operatoren benötigen.
OpenAI-kompatible Option
Verwenden Sie die OpenAI-kompatible Route, wenn Sie eine bestehende OpenAI SDK- oder Chat Completions-App migrieren und keine nativen Gemini-Request-Felder benötigen.Erklärung des Ablaufs
Mischen Sie die beiden Request-Formate nicht. Native Gemini-Felder wie
contents und generationConfig gehören auf die Route generateContent. Chat Completions-Felder wie messages gehören auf die OpenAI-kompatible Route.
Fehlerbehebung / FAQ
Mit welchem Pfad sollte ich beginnen
Mit welchem Pfad sollte ich beginnen
Beginnen Sie mit dem nativen Gemini-
generateContent, wenn Sie einen neuen Gemini-Workflow erstellen. Verwenden Sie die OpenAI-kompatible Route, wenn eine bestehende App bereits von OpenAI SDK oder Chat Completions-Request-Formaten abhängt.Native Gemini-Felder schlagen bei Chat Completions fehl
Native Gemini-Felder schlagen bei Chat Completions fehl
Senden Sie
contents-, parts-, generationConfig- und streamGenerateContent-Requests an den nativen Gemini-Endpunkt. Die OpenAI-kompatible Route erwartet messages und Chat Completions-Parameter.Die Gemini-Modell-ID schlägt fehl
Die Gemini-Modell-ID schlägt fehl
Bestätigen Sie, dass die Modell-ID für Ihr Konto verfügbar ist und die Route unterstützt, die Sie aufrufen. Verwenden Sie die Modellseite, um aktuelle Modell-IDs zu finden.
Das SDK zeigt auf den falschen Dienst
Das SDK zeigt auf den falschen Dienst
Setzen Sie für Google GenAI SDK-Requests die base URL auf
https://api.cometapi.com. Setzen Sie für OpenAI SDK-Requests base_url in Python oder baseURL in Node.js auf https://api.cometapi.com/v1.Nächste Schritte
- Verwenden Sie die Gemini native API reference für vollständige
generateContent-Request- und Response-Felder. - Lesen Sie die Chat Completions API reference für das OpenAI-kompatible Request-Format.
- Konfigurieren Sie OpenAI SDK-Clients in Use CometAPI with OpenAI SDKs.
- Listen Sie verfügbare Modelle mit List available CometAPI models auf.
- Fügen Sie Wiederholungs- und Rate-Limit-Behandlung mit Error codes and retry strategy hinzu.