O que você vai criar
Você enviará uma solicitação nativa GeminiPOST /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:x-goog-api-key para solicitações HTTP nativas diretas do Gemini:
Formato nativo do Gemini
As solicitações nativas do Gemini usamcontents, 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
Com qual caminho devo começar
Com qual caminho devo começar
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.Campos nativos do Gemini falham no Chat Completions
Campos nativos do Gemini falham no 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.O model ID do Gemini falha
O model ID do Gemini falha
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.
O SDK aponta para o serviço errado
O SDK aponta para o serviço errado
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
- Use a referência da API nativa do Gemini para ver todos os campos de solicitação e resposta de
generateContent. - Leia a referência da API Chat Completions para o formato de solicitação compatível com OpenAI.
- Configure clientes do OpenAI SDK em Use a CometAPI com SDKs OpenAI.
- Liste os modelos disponíveis com Liste os modelos disponíveis da CometAPI.
- Adicione tratamento de retry e rate-limit com Códigos de erro e estratégia de retry.