Hva du skal bygge
Du skal sende en native GeminiPOST /v1beta/models/\{model\}:generateContent-forespørsel, og deretter sammenligne den med det OpenAI-kompatible alternativet POST /v1/chat/completions for apper som allerede bruker Chat Completions-forespørselsformat.
Forutsetninger
- En CometAPI API-nøkkel lagret i
COMETAPI_KEY - En Gemini tekstmodell-ID fra Models page
curl, Python 3.10+ eller Node.js 18+
API-nøkkel, base URL, autentisering
Bruk Gemini-native endepunktet når du vil bruke Gemini-forespørselsfelter:x-goog-api-key for direkte native Gemini HTTP-forespørsler:
Native Gemini-format
Native Gemini-forespørsler brukercontents, parts og generationConfig. Bruk denne stien når du trenger Gemini-spesifikke felter som tenkekontroller, mediedeler, Google Search-grounding eller native streaming-operatorer.
OpenAI-kompatibelt alternativ
Bruk den OpenAI-kompatible ruten når du migrerer en eksisterende OpenAI SDK- eller Chat Completions-app og ikke trenger Gemini-native forespørselsfelter.Forklaring av flyt
Ikke bland de to forespørselsformatene. Native Gemini-felter som
contents og generationConfig hører til på generateContent-ruten. Chat Completions-felter som messages hører til på den OpenAI-kompatible ruten.
Feilsøking / FAQ
Hvilken sti bør jeg starte med
Hvilken sti bør jeg starte med
Start med native Gemini
generateContent når du bygger en ny Gemini-arbeidsflyt. Bruk den OpenAI-kompatible ruten når en eksisterende app allerede er avhengig av OpenAI SDK eller Chat Completions-forespørselsformat.Native Gemini-felter feiler på Chat Completions
Native Gemini-felter feiler på Chat Completions
Send
contents, parts, generationConfig og streamGenerateContent-forespørsler til Gemini-native endepunktet. Den OpenAI-kompatible ruten forventer messages og Chat Completions-parametere.Gemini model ID feiler
Gemini model ID feiler
Bekreft at model ID er tilgjengelig for kontoen din og støtter ruten du kaller. Bruk Models page for å finne gjeldende model ID-er.
SDK-en peker til feil tjeneste
SDK-en peker til feil tjeneste
For Google GenAI SDK-forespørsler setter du base URL til
https://api.cometapi.com. For OpenAI SDK-forespørsler setter du base_url i Python eller baseURL i Node.js til https://api.cometapi.com/v1.Neste steg
- Bruk Gemini native API reference for fullstendige felter for
generateContent-forespørsel og -respons. - Les Chat Completions API reference for det OpenAI-kompatible forespørselsformatet.
- Konfigurer OpenAI SDK-klienter i Use CometAPI with OpenAI SDKs.
- List opp tilgjengelige modeller med List available CometAPI models.
- Legg til håndtering av retry og rate limits med Error codes and retry strategy.