Skip to main content

Lo que vas a crear

Enviarás una solicitud nativa de Gemini POST /v1beta/models/\{model\}:generateContent, y luego la compararás con la opción compatible con OpenAI POST /v1/chat/completions para aplicaciones que ya usan formatos de solicitud de Chat Completions.

Requisitos previos

  • Una clave de API de CometAPI almacenada en COMETAPI_KEY
  • Un model ID de modelo de texto de Gemini de la página de modelos
  • curl, Python 3.10+ o Node.js 18+

Clave de API, URL base, autenticación

Usa el endpoint nativo de Gemini cuando quieras campos de solicitud de Gemini:
Usa x-goog-api-key para solicitudes HTTP nativas directas de Gemini:
Usa la URL base compatible con OpenAI solo cuando tu aplicación ya use Chat Completions:

Formato nativo de Gemini

Las solicitudes nativas de Gemini usan contents, parts y generationConfig. Usa esta ruta cuando necesites campos específicos de Gemini, como controles de thinking, partes multimedia, grounding de Google Search u operadores nativos de Streaming.

Opción compatible con OpenAI

Usa la ruta compatible con OpenAI cuando estés migrando un SDK de OpenAI o una aplicación de Chat Completions existente y no necesites campos de solicitud nativos de Gemini.

Explicación del flujo

No mezcles los dos formatos de solicitud. Los campos nativos de Gemini como contents y generationConfig pertenecen a la ruta generateContent. Los campos de Chat Completions como messages pertenecen a la ruta compatible con OpenAI.

Solución de problemas / Preguntas frecuentes

Empieza con generateContent nativo de Gemini cuando estés creando un nuevo flujo de trabajo de Gemini. Usa la ruta compatible con OpenAI cuando una aplicación existente ya dependa del SDK de OpenAI o de formatos de solicitud de Chat Completions.
Envía solicitudes de contents, parts, generationConfig y streamGenerateContent al endpoint nativo de Gemini. La ruta compatible con OpenAI espera messages y parámetros de Chat Completions.
Confirma que el model ID esté disponible para tu cuenta y sea compatible con la ruta que estás llamando. Usa la página de modelos para encontrar los model ID actuales.
Para solicitudes del SDK de Google GenAI, establece la URL base en https://api.cometapi.com. Para solicitudes del SDK de OpenAI, establece base_url en Python o baseURL en Node.js en https://api.cometapi.com/v1.

Próximos pasos