Skip to main content

Wat je gaat bouwen

Je stuurt een native Gemini POST /v1beta/models/\{model\}:generateContent-request en vergelijkt die vervolgens met de OpenAI-compatibele POST /v1/chat/completions-optie voor apps die al Chat Completions-requestvormen gebruiken.

Vereisten

  • Een CometAPI API-sleutel opgeslagen in COMETAPI_KEY
  • Een Gemini-tekstmodel model ID van de Models page
  • curl, Python 3.10+, of Node.js 18+

API-sleutel, basis-URL, authenticatie

Gebruik de native Gemini-endpoint wanneer je Gemini-requestvelden wilt gebruiken:
Gebruik x-goog-api-key voor directe native Gemini HTTP-requests:
Gebruik de OpenAI-compatibele basis-URL alleen wanneer je applicatie al Chat Completions gebruikt:

Native Gemini-indeling

Native Gemini-requests gebruiken contents, parts en generationConfig. Gebruik dit pad wanneer je Gemini-specifieke velden nodig hebt, zoals thinking-controls, media-onderdelen, Google Search-grounding of native streaming-operators.

OpenAI-compatibele optie

Gebruik de OpenAI-compatibele route wanneer je een bestaande OpenAI SDK- of Chat Completions-app migreert en geen native Gemini-requestvelden nodig hebt.

Uitleg van de flow

Mix de twee requestindelingen niet. Native Gemini-velden zoals contents en generationConfig horen bij de generateContent-route. Chat Completions-velden zoals messages horen bij de OpenAI-compatibele route.

Probleemoplossing / FAQ

Begin met native Gemini generateContent wanneer je een nieuwe Gemini-workflow bouwt. Gebruik de OpenAI-compatibele route wanneer een bestaande app al afhankelijk is van OpenAI SDK of Chat Completions-requestvormen.
Stuur contents, parts, generationConfig en streamGenerateContent-requests naar de native Gemini-endpoint. De OpenAI-compatibele route verwacht messages en Chat Completions-parameters.
Controleer of het model ID beschikbaar is voor je account en de route ondersteunt die je aanroept. Gebruik de Models page om actuele model IDs te vinden.
Stel voor Google GenAI SDK-requests de basis-URL in op https://api.cometapi.com. Stel voor OpenAI SDK-requests base_url in Python of baseURL in Node.js in op https://api.cometapi.com/v1.

Volgende stappen