Lo que vas a crear
Enviarás una solicitud nativa de GeminiPOST /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:x-goog-api-key para solicitudes HTTP nativas directas de Gemini:
Formato nativo de Gemini
Las solicitudes nativas de Gemini usancontents, 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
¿Con qué ruta debería empezar?
¿Con qué ruta debería empezar?
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.Los campos nativos de Gemini fallan en Chat Completions
Los campos nativos de Gemini fallan en 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.El model ID de Gemini falla
El model ID de Gemini falla
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.
El SDK apunta al servicio incorrecto
El SDK apunta al servicio incorrecto
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
- Usa la referencia de la API nativa de Gemini para ver todos los campos de solicitud y respuesta de
generateContent. - Lee la referencia de la API de Chat Completions para el formato de solicitud compatible con OpenAI.
- Configura clientes del SDK de OpenAI en Usar CometAPI con SDKs de OpenAI.
- Enumera los modelos disponibles con List available CometAPI models.
- Añade manejo de reintentos y límites de tasa con Error codes and retry strategy.