Cosa creerai
Invierai una richiesta nativa GeminiPOST /v1beta/models/\{model\}:generateContent, quindi la confronterai con l’opzione compatibile con OpenAI POST /v1/chat/completions per le app che usano già i formati di richiesta Chat Completions.
Prerequisiti
- Una chiave API CometAPI archiviata in
COMETAPI_KEY - Un model ID di un modello di testo Gemini dalla pagina Models
curl, Python 3.10+ o Node.js 18+
Chiave API, URL di base, autenticazione
Usa l’endpoint nativo Gemini quando vuoi usare i campi di richiesta Gemini:x-goog-api-key per richieste HTTP Gemini native dirette:
Formato Gemini nativo
Le richieste Gemini native usanocontents, parts e generationConfig. Usa questo percorso quando ti servono campi specifici di Gemini come controlli di thinking, parti multimediali, grounding con Google Search o operatori di streaming nativi.
Opzione compatibile con OpenAI
Usa il percorso compatibile con OpenAI quando stai migrando un’app esistente basata su OpenAI SDK o Chat Completions e non ti servono i campi di richiesta nativi di Gemini.Spiegazione del flusso
Non mischiare i due formati di richiesta. I campi nativi di Gemini come
contents e generationConfig appartengono al percorso generateContent. I campi Chat Completions come messages appartengono al percorso compatibile con OpenAI.
Risoluzione dei problemi / FAQ
Con quale percorso dovrei iniziare
Con quale percorso dovrei iniziare
Inizia con
generateContent nativo di Gemini quando stai creando un nuovo flusso di lavoro Gemini. Usa il percorso compatibile con OpenAI quando un’app esistente dipende già da OpenAI SDK o dai formati di richiesta Chat Completions.I campi nativi Gemini falliscono su Chat Completions
I campi nativi Gemini falliscono su Chat Completions
Invia richieste
contents, parts, generationConfig e streamGenerateContent all’endpoint nativo Gemini. Il percorso compatibile con OpenAI si aspetta messages e parametri Chat Completions.Il model ID Gemini non funziona
Il model ID Gemini non funziona
Conferma che il model ID sia disponibile per il tuo account e supporti il percorso che stai chiamando. Usa la pagina Models per trovare i model ID correnti.
L'SDK punta al servizio sbagliato
L'SDK punta al servizio sbagliato
Per le richieste Google GenAI SDK, imposta l’URL di base su
https://api.cometapi.com. Per le richieste OpenAI SDK, imposta base_url in Python o baseURL in Node.js su https://api.cometapi.com/v1.Passaggi successivi
- Usa il riferimento API nativo Gemini per tutti i campi di richiesta e risposta di
generateContent. - Leggi il riferimento API Chat Completions per il formato di richiesta compatibile con OpenAI.
- Configura i client OpenAI SDK in Usare CometAPI con OpenAI SDK.
- Elenca i modelli disponibili con Elencare i modelli CometAPI disponibili.
- Aggiungi la gestione dei retry e dei rate limit con Codici di errore e strategia di retry.