Skip to main content

O que você vai criar

Você enviará uma solicitação nativa Gemini POST /v1beta/models/\{model\}:generateContent e, em seguida, a comparará com a opção compatível com OpenAI POST /v1/chat/completions para apps que já usam formatos de solicitação do Chat Completions.

Pré-requisitos

  • Uma chave de API da CometAPI armazenada em COMETAPI_KEY
  • Um model ID de texto Gemini da página de modelos
  • curl, Python 3.10+ ou Node.js 18+

Chave de API, URL base, autenticação

Use o endpoint nativo do Gemini quando quiser campos de solicitação do Gemini:
Use x-goog-api-key para solicitações HTTP nativas diretas do Gemini:
Use a URL base compatível com OpenAI apenas quando sua aplicação já usar Chat Completions:

Formato nativo do Gemini

As solicitações nativas do Gemini usam contents, parts e generationConfig. Use este caminho quando precisar de campos específicos do Gemini, como controles de thinking, partes de mídia, grounding com Google Search ou operadores de streaming nativos.

Opção compatível com OpenAI

Use a rota compatível com OpenAI quando estiver migrando um SDK OpenAI existente ou um app Chat Completions e não precisar de campos de solicitação nativos do Gemini.

Explicação do fluxo

Não misture os dois formatos de solicitação. Campos nativos do Gemini, como contents e generationConfig, pertencem à rota generateContent. Campos do Chat Completions, como messages, pertencem à rota compatível com OpenAI.

Solução de problemas / FAQ

Comece com o Gemini nativo generateContent quando estiver criando um novo fluxo de trabalho com Gemini. Use a rota compatível com OpenAI quando um app existente já depender de formatos de solicitação do SDK OpenAI ou do Chat Completions.
Envie solicitações contents, parts, generationConfig e streamGenerateContent para o endpoint nativo do Gemini. A rota compatível com OpenAI espera messages e parâmetros do Chat Completions.
Confirme que o model ID está disponível para sua conta e oferece suporte à rota que você está chamando. Use a página de modelos para encontrar os model IDs atuais.
Para solicitações com o Google GenAI SDK, defina a URL base como https://api.cometapi.com. Para solicitações com o OpenAI SDK, defina base_url em Python ou baseURL em Node.js como https://api.cometapi.com/v1.

Próximos passos