Guía de integración de agents
Usa Gemini CLI con la API LLM de WaveSpeed
Esta guía muestra cómo conectar Gemini CLI a WaveSpeed AI con ~/.gemini/.env, Gemini generateContent API, /v1beta/models/{model}:generateContent, base URL https://llm.wavespeed.ai/v1 y el modelo predeterminado deepseek/deepseek-v4.1-flash-1017. Copia la configuración anterior, exporta tu API key, ejecuta el agent y verifica los requests en Logs.
Crea una clave de acceso de WaveSpeed
Exporta la clave requerida localmente
Pega la configuración en
~/.gemini/.envEjecuta gemini y revisa Logs
Qué configura este setup de Gemini CLI
Protocolo
Gemini generateContent API
Endpoint
/v1beta/models/{model}:generateContent
Modelo
deepseek/deepseek-v4.1-flash-1017
La configuración lista para copiar de arriba es el único archivo de Gemini CLI que necesitas editar para el setup recomendado: ~/.gemini/.env. Mantén la API key en tu entorno shell para no enviarla a un repositorio.
Solución de problemas
La API key no se detecta
Exporta WAVESPEED_API_KEY en la misma shell donde ejecutas Gemini CLI. Si usas un perfil de shell, recarga la terminal antes de iniciar el agent.
Los requests fallan con un error de protocolo o endpoint
Comprueba que Gemini CLI usa Gemini generateContent API y endpoint /v1beta/models/{model}:generateContent. Los desajustes de protocolo son la causa más común de errores 404 o de payload.
El modelo seleccionado no funciona
Confirma que el ID del modelo existe en WaveSpeed Models y pega el ID exacto en ~/.gemini/.env. Puedes empezar con el modelo predeterminado que aparece en esta página.
No aparecen requests en Logs
Asegúrate de que Gemini CLI usa la base URL de WaveSpeed y tu API key actual. Luego envía un prompt nuevo desde el agent local y actualiza Logs.
¿Puede esta guía de Gemini CLI aparecer en buscadores?
Sí. Esta página está creada como guía indexable para usuarios que buscan custom provider de Gemini CLI, endpoint compatible con OpenAI, base URL y flujos de configuración local de agents.