Skip to main content

Cosa creerai

Invierai una richiesta nativa Gemini POST /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:
Usa x-goog-api-key per richieste HTTP Gemini native dirette:
Usa l’URL di base compatibile con OpenAI solo quando la tua applicazione usa già Chat Completions:

Formato Gemini nativo

Le richieste Gemini native usano contents, 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

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.
Invia richieste contents, parts, generationConfig e streamGenerateContent all’endpoint nativo Gemini. Il percorso compatibile con OpenAI si aspetta messages e parametri Chat Completions.
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.
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