Wat je gaat bouwen
Je stuurt een native GeminiPOST /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:x-goog-api-key voor directe native Gemini HTTP-requests:
Native Gemini-indeling
Native Gemini-requests gebruikencontents, 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
Met welk pad moet ik beginnen
Met welk pad moet ik beginnen
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.Native Gemini-velden falen op Chat Completions
Native Gemini-velden falen op Chat Completions
Stuur
contents, parts, generationConfig en streamGenerateContent-requests naar de native Gemini-endpoint. De OpenAI-compatibele route verwacht messages en Chat Completions-parameters.Het Gemini-model model ID faalt
Het Gemini-model model ID faalt
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.
De SDK wijst naar de verkeerde service
De SDK wijst naar de verkeerde service
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
- Gebruik de Gemini native API reference voor volledige
generateContent-request- en responsevelden. - Lees de Chat Completions API reference voor de OpenAI-compatibele requestvorm.
- Configureer OpenAI SDK-clients in Use CometAPI with OpenAI SDKs.
- Toon beschikbare modellen met List available CometAPI models.
- Voeg retry- en rate-limit-afhandeling toe met Error codes and retry strategy.