Skip to main content

Was Sie erstellen werden

Sie senden einen nativen Gemini-Request an POST /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_KEY gespeicherter 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:
Verwenden Sie x-goog-api-key für direkte native Gemini-HTTP-Requests:
Verwenden Sie die OpenAI-kompatible base URL nur, wenn Ihre Anwendung bereits Chat Completions verwendet:

Natives Gemini-Format

Native Gemini-Requests verwenden contents, 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

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.
Senden Sie contents-, parts-, generationConfig- und streamGenerateContent-Requests an den nativen Gemini-Endpunkt. Die OpenAI-kompatible Route erwartet messages und Chat Completions-Parameter.
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.
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