Documentación de HopBaseChat de Gemini
Llame a los modelos de Gemini mediante el protocolo compatible con OpenAI y la API de Interactions.
Los modelos de chat de Gemini usan el protocolo compatible con OpenAI Chat Completions: POST https://api.hop-base.com/v1/chat/completions con Authorization: Bearer sk-tu-clave. Los SDK de OpenAI existentes y los clientes de terceros solo necesitan un ID de modelo de Gemini.
Modelos disponibles
| Familia | ID del modelo | Caso de uso |
|---|---|---|
| Gemini Omni | gemini-omni-flash-preview | Entrada de texto, imagen y video; salida de video |
| Gemini 3.6 | gemini-3.6-flash | Modelo Flash más reciente; actualmente en observación |
| Gemini 3.5 | gemini-3.5-flash / gemini-3.5-flash-lite | Predeterminado recomendado / bajo costo |
| Gemini 3.1 Pro | gemini-3.1-pro-preview / gemini-3.1-pro-preview-customtools | Vista previa de razonamiento avanzado / vista previa de uso de herramientas |
| Gemini 3.1 | gemini-3.1-flash-lite / gemini-3.1-flash-lite-preview | Ligero / vista previa ligera |
| Gemini 3 | gemini-3-flash-preview | Vista previa de Gemini 3 Flash |
| Gemini 2.5 | gemini-2.5-pro / gemini-2.5-flash / gemini-2.5-flash-lite | Modelos estables |
Use gemini-3.5-flash de forma predeterminada. Los modelos estables de Gemini 2.5 son el respaldo maduro. gemini-3.6-flash está recién disponible y permanece en observación. Trate todo ID de modelo que contenga preview como una vista previa sin garantía de estabilidad.
El precio de referencia de Google para gemini-3.1-pro-preview es de $2 por millón de tokens de entrada y $12 por millón de tokens de salida. Los precios y multiplicadores reales varían según el grupo del plan; la Plaza de modelos con sesión iniciada para la clave actual es la fuente autorizada.
Ejemplo con curl
curl https://api.hop-base.com/v1/chat/completions \
-H "Authorization: Bearer sk-tu-clave" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.5-flash",
"messages": [{"role": "user", "content": "Hola"}]
}'Transmisión con SSE (agregue "stream": true)
curl https://api.hop-base.com/v1/chat/completions \
-H "Authorization: Bearer sk-tu-clave" \
-H "Content-Type: application/json" \
-d '{"model": "gemini-3.1-pro-preview", "stream": true,
"messages": [{"role": "user", "content": "Hola"}]}'Transferencia directa del payload nativo de Gemini
Los cuerpos de solicitud existentes del SDK de Gemini pueden conservar su campo nativo contents. El mismo endpoint detecta el formato y lo reenvía como una solicitud nativa de Gemini.
curl https://api.hop-base.com/v1/chat/completions \
-H "Authorization: Bearer sk-tu-clave" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.5-flash",
"contents": [{"role": "user", "parts": [{"text": "Hola"}]}]
}'Generación de video con Gemini Omni (Interactions nativo)
gemini-omni-flash-preview acepta texto, imágenes y video, y puede generar video directamente. La conversión de texto a video solo necesita model e input. Use POST https://api.hop-base.com/v1beta/interactions para obtener la respuesta de video nativa completa. El endpoint de Chat Completions sigue disponible para chat de texto, pero no debe usarse para recibir el payload de video completo. POST /v1/interactions se mantiene como alias de compatibilidad.
curl https://api.hop-base.com/v1beta/interactions \
-H "Authorization: Bearer sk-tu-clave" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-omni-flash-preview",
"input": "Genera un video de 3 segundos de una pelota roja rodando lentamente sobre un fondo blanco"
}'El video está en steps[].content[]. data contiene un MP4 codificado en base64, y el consumo de tokens de video se registra en usage.output_tokens_by_modality para efectos de facturación.
{
"status": "completed",
"model": "gemini-omni-flash-preview",
"steps": [{
"type": "model_output",
"content": [{
"type": "video",
"mime_type": "video/mp4",
"data": "<base64-mp4>"
}]
}],
"usage": {
"total_input_tokens": 20,
"total_output_tokens": 17819,
"output_tokens_by_modality": [{"modality": "video", "tokens": 17376}]
}
}La entrada de video está limitada a 10 segundos. La salida es de 3 a 10 segundos a 720p y 24 FPS. Indique la duración deseada en input. El contexto del modelo es de 1,048,576 tokens; las capacidades y disponibilidad de la vista previa pueden cambiar.
Los modelos de Gemini disponibles varían según el grupo del plan. Llame a GET /v1/models con la clave actual y use únicamente los ID completos que devuelva esa respuesta.