Skip to main content

Introducción

Gemini CLI es la herramienta de línea de comandos oficial de Google que permite a los desarrolladores interactuar con los modelos de IA Gemini desde el terminal. Tras configurar la API de APIMart, puede usar los modelos avanzados de APIMart —GPT, Claude y Gemini— en Gemini CLI.

Requisitos previos

Antes de comenzar:
  1. Node.js y npm instalados
    Descargue e instale desde el sitio web de Node.js (se recomienda v16 o superior)
  2. Clave de API de APIMart
    Inicie sesión en la Consola de APIMart y copie su clave de API (comienza con sk-)
Consejo: Si aún no tiene una cuenta en APIMart, regístrese primero en APIMart y cree una clave de API.

Paso 1: Instalar Gemini CLI

1.1 Instalación global

Instale Gemini CLI globalmente con npm:

1.2 Verificar la instalación

Compruebe que la CLI está disponible:
Si se imprime un número de versión, la instalación fue correcta.
Consejo: Si no se encuentra el comando, reinicie el terminal o verifique la configuración del PATH global de npm.

Paso 2: Configurar la API de APIMart

2.1 Variables de entorno temporales

Para pruebas o uso puntual; los valores se borran al cerrar el terminal. Windows (PowerShell):
macOS/Linux (Bash):

2.2 Variables de entorno permanentes (recomendado)

Persista la configuración para que los nuevos shells la carguen automáticamente. Windows (PowerShell):
  1. Ejecute PowerShell como Administrador
  2. Configure variables de entorno a nivel de usuario:
  1. Reinicie PowerShell o recargue las variables:
macOS/Linux (Bash):
  1. Edite su archivo rc del shell:
  1. Añada:
  1. Recargue:

2.3 Usar un archivo .env

Cree .env en su proyecto:
Cargue las variables antes de ejecutar Gemini: macOS/Linux:
Windows (PowerShell):
Importante: - Reemplace sk-xxxxxxxxxxxx con su clave real de la Consola de APIMart - Establezca GEMINI_BASE_URL en https://api.apimart.ai/v1 para que Gemini CLI se comunique con APIMart - Añada .env a .gitignore para que las claves no se confirmen al repositorio

2.4 Verificar la configuración

macOS/Linux:
Windows (PowerShell):
Si los valores parecen correctos, la configuración fue correcta.

Paso 3: Usar Gemini CLI

3.1 Chat básico

Sesión interactiva:
Prompt único:

3.2 Elegir un modelo

O:

3.3 Leer prompts desde un archivo

O canalizar:

3.4 Guardar la salida en un archivo

Paso 4: Llamar a APIMart desde su código

4.1 SDK de Python

4.2 JavaScript / TypeScript

4.3 cURL

Paso 5: Elegir un modelo

Modelos recomendados

APIMart admite muchos modelos; elija según la tarea y el presupuesto. Gemini GPT Claude
Selecciones rápidas: - 🚀 Stack al estilo Google: gemini-2.0-flash-exp, gemini-2.5-pro - 💡 Programación: claude-sonnet-4-5-20250929, gpt-5 - 💰 Costo: gpt-4o-mini, claude-haiku-4-5-20251001 - ⚡ Velocidad: gemini-2.0-flash-exp, gpt-4o-mini

Características avanzadas

Multimodal (imágenes)

Con un modelo multimodal como Gemini 2.0 Flash:

Streaming

Transmita tokens a medida que llegan:

Ajustar parámetros

Modele la aleatoriedad y la longitud:

Preguntas frecuentes

Q1: “Invalid API key” o errores de autenticación

  1. Formato de la clave
    • Debe comenzar con sk-
    • Sin espacios adicionales al pegar
  2. Variables de entorno
  3. Estado de la clave

Q2: ¿Cómo verifico la configuración de la API?

Q3: ¿Qué lenguajes son compatibles?

Cualquier lenguaje que pueda enviar solicitudes HTTP funciona con APIMart:
  • Python: se recomienda el SDK de OpenAI
  • JavaScript / TypeScript: Node o navegador
  • Java: cliente HTTP
  • Go: biblioteca estándar o bibliotecas
  • PHP: cURL o Guzzle
  • Ruby: gemas HTTP
  • C# / .NET: HttpClient
  • Swift: URLSession
  • Otros: cualquier cosa con HTTP

Q4: ¿Dónde puedo ver el uso y la facturación?

En la Consola de APIMart:
  • 📊 Estadísticas de llamadas en vivo
  • 💰 Costos y facturas
  • 📈 Tendencias de uso
  • 🔍 Registros de solicitudes
  • ⚙️ Gestión de claves de API

Q5: Errores comunes de API

Mejores prácticas

1. Reintentos y retroceso

2. Control de costos

3. Prompts del sistema

Características

Con Google AI Studio y APIMart obtiene:
  • 🤖 Muchos modelos: GPT, Claude, Gemini y más
  • 🌍 Compatible con OpenAI: forma familiar de solicitud / respuesta
  • Rendimiento: baja latencia, alta concurrencia
  • 💰 Precios claros: pague por uso
  • 📊 Observabilidad: supervise las llamadas en tiempo real
  • 🔒 Seguridad: salvaguardas orientadas a empresas
  • 🚀 Integración rápida: llamadas HTTP / SDK simples
  • 📚 Documentación: guías y ejemplos

Soporte


Comience con APIMart

Cree una cuenta, obtenga una clave de API y use múltiples modelos de IA desde los flujos de trabajo de Google AI Studio y más.