9router/gitbook/content/es/faq.md
2026-05-11 11:50:24 +07:00

10 KiB

Preguntas frecuentes

Preguntas comunes sobre 9Router.


¿Qué es 9Router?

9Router es un router de modelos de IA que maximiza el valor de tu suscripción y minimiza los costos.

Enruta inteligentemente las solicitudes a través de múltiples proveedores de IA usando un sistema de fallback de 3 niveles:

  1. Nivel de suscripción - Maximiza las cuotas de Claude Code, Codex, Gemini que ya pagas
  2. Nivel barato - Alternativas ultra-baratas ($0.20-$0.60 por 1M tokens)
  3. Nivel gratis - Respaldo de emergencia con modelos gratis ilimitados

Beneficios clave:

  • Nunca desperdicies la cuota de suscripción
  • Fallback automático cuando se agota la cuota
  • Seguimiento de cuota en tiempo real
  • 90% de ahorro en costos vs uso directo de API

¿Cómo funciona el precio?

9Router usa una estrategia de precios de 3 niveles:

Nivel 1: Suscripción (Maximiza primero)

  • Claude Code (Pro/Max): $20-100/mes - Cuota de 5 horas + semanal
  • OpenAI Codex (Plus/Pro): $20-200/mes - Cuota de 5 horas + semanal
  • Gemini CLI: GRATIS - 180K completados/mes + 1K/día
  • GitHub Copilot: $10-19/mes - Reinicio mensual
  • Antigravity: GRATIS - Similar a Gemini

Objetivo: ¡Usa cada bit de cuota antes de que se reinicie!

Nivel 2: Barato (Respaldo)

  • GLM-4.7: $0.60/$2.20 por 1M tokens - Reinicio diario 10AM
  • MiniMax M2.1: $0.20/$1.00 por 1M tokens - 5 horas rolling
  • Kimi K2: $9/mes plano (10M tokens)

Objetivo: ¡90% más barato que ChatGPT API ($20/1M)!

Nivel 3: Gratis (Emergencia)

  • iFlow: 8 modelos GRATIS (Kimi K2, Qwen3, GLM, MiniMax...)
  • Qwen: 3 modelos GRATIS (Qwen3 Coder Plus/Flash, Vision)
  • Kiro: 2 modelos GRATIS (Claude Sonnet 4.5, Haiku 4.5)

Objetivo: ¡Fallback de cero costo cuando todo lo demás está limitado por cuota!


¿9Router es gratis?

Sí, 9Router en sí es 100% gratis y open source.

Proveedores de nivel gratis disponibles:

  • Gemini CLI - 180K completados/mes (cuenta Google GRATIS)
  • iFlow - 8 modelos ilimitados (OAuth GRATIS)
  • Qwen - 3 modelos ilimitados (OAuth GRATIS)
  • Kiro - Claude Sonnet/Haiku (AWS Builder ID GRATIS)

¡Puedes codificar GRATIS para siempre usando solo proveedores de nivel gratis!

Proveedores de pago opcionales:

  • Servicios de suscripción que ya puedes tener (Claude Code, Codex, Copilot)
  • Alternativas ultra-baratas ($0.20-$0.60 por 1M tokens)

¿Qué proveedores son compatibles?

Proveedores de suscripción

  • Claude Code (Pro/Max) - Claude 4.5 Opus/Sonnet/Haiku
  • OpenAI Codex (Plus/Pro) - GPT 5.2 Codex, GPT 5.1 Codex Max
  • Gemini CLI (GRATIS) - Gemini 3 Flash/Pro, 2.5 Pro/Flash
  • GitHub Copilot - GPT-5, Claude 4.5, Gemini 3
  • Antigravity (Google) - Gemini 3 Pro, Claude Sonnet 4.5

Proveedores baratos

  • GLM (Zhipu AI) - GLM 4.7, GLM 4.6V Vision
  • MiniMax - MiniMax M2.1
  • Kimi (Moonshot AI) - Kimi Latest
  • OpenRouter - Passthrough a cualquier modelo de OpenRouter

Proveedores gratis

  • iFlow - 8 modelos (Kimi K2, Qwen3, GLM, MiniMax, DeepSeek...)
  • Qwen - 3 modelos (Qwen3 Coder Plus/Flash, Vision)
  • Kiro - 2 modelos (Claude Sonnet 4.5, Haiku 4.5)

Total: 15+ proveedores, 50+ modelos

Consulta la documentación de proveedores para más detalles.


¿Puedo usar múltiples proveedores?

¡Sí! Esta es la característica principal de 9Router.

Los combos te permiten encadenar múltiples proveedores con fallback automático:

Ejemplo de combo: "premium-coding"
1. cc/claude-opus-4-5 (Suscripción principal)
2. glm/glm-4.7 (Respaldo barato)
3. if/kimi-k2 (Emergencia gratis)

→ Cambio automático cuando se agota la cuota
→ Nunca para de codificar
→ Costo extra mínimo

Cómo crear combos:

Dashboard → Combos → Create New
→ Agrega modelos en orden de prioridad
→ Usa el nombre del combo en CLI: "premium-coding"

Beneficios:

  • Cero tiempo de inactividad cuando se agota la cuota
  • Optimización automática de costos
  • Un solo nombre de modelo para todas las herramientas

Consulta la documentación de combos para ejemplos.


¿Cómo funciona el seguimiento de cuota?

9Router rastrea la cuota en tiempo real para todos los proveedores:

Características:

  • Consumo de tokens - Tokens de entrada/salida por solicitud
  • Cuenta regresiva de reinicio - Tiempo hasta que se refresca la cuota
  • Estadísticas de uso - Reportes diarios/semanales/mensuales
  • Estimación de costos - Gasto proyectado (niveles de pago)
  • Alertas de cuota - Notificaciones cuando la cuota es baja

Tipos de cuota:

  • 5 horas rolling - Claude Code, Codex, MiniMax
  • Reinicio diario - Gemini CLI (1K/día), GLM (10AM)
  • Reinicio semanal - Claude Code, Codex (cuota adicional)
  • Reinicio mensual - Gemini CLI (180K), GitHub Copilot (día 1)

Ver cuota:

Dashboard → Providers → Quota Tracking
→ Uso en tiempo real + cuenta regresiva de reinicio

Consulta la documentación de seguimiento de cuota para detalles.


¿9Router funciona con Cursor?

Sí, pero Cursor requiere un endpoint en la nube.

Problema: Cursor IDE no soporta endpoints en localhost.

Solución: Usa el despliegue en la nube de 9Router:

Cursor Settings → Models → Advanced:
  OpenAI API Base URL: https://9router.com/v1
  OpenAI API Key: [desde el dashboard]
  Model: cc/claude-opus-4-5-20251101

Alternativa: Auto-hospéda en VPS con dominio público:

# Despliega en VPS
git clone https://github.com/decolua/9router.git
cd 9router/app
npm install && npm run build
npm start

# Configura proxy reverso Nginx
# Apunta Cursor a: https://your-domain.com/v1

Otras herramientas CLI funcionan con localhost:

  • Cline
  • Claude Desktop
  • Codex CLI
  • Continue
  • RooCode

Consulta la guía de integración de Cursor para detalles.


¿Puedo auto-hospedar 9Router?

¡Sí! 9Router soporta múltiples opciones de despliegue:

Localhost (Por defecto)

npm install -g 9router
9router
→ Dashboard: http://localhost:3000
→ API: http://localhost:20128/v1

VPS/Cloud

git clone https://github.com/decolua/9router.git
cd 9router/app
npm install && npm run build

export JWT_SECRET="your-secure-secret"
export INITIAL_PASSWORD="your-password"
export NODE_ENV="production"

npm start

Docker

docker build -t 9router .
docker run -d \
  -p 3000:3000 \
  -e JWT_SECRET="your-secret" \
  -v 9router-data:/app/data \
  9router

Cloudflare Workers

cd 9router/app
npm run deploy:cloudflare

Variables de entorno:

  • JWT_SECRET - ¡DEBE cambiarse en producción!
  • DATA_DIR - Ruta de almacenamiento de la base de datos (por defecto: ~/.9router)
  • INITIAL_PASSWORD - Login del dashboard (por defecto: 123456)
  • NODE_ENV - Establece en production para desplegar

Consulta la guía de despliegue para detalles.


¿Mis datos están seguros?

Sí, 9Router prioriza la seguridad y privacidad:

Almacenamiento local:

  • Todos los datos se almacenan localmente en ~/.9router (o DATA_DIR personalizado)
  • No se envían datos a los servidores de 9Router
  • Tokens OAuth cifrados con JWT

Sin telemetría:

  • Sin seguimiento de uso
  • Sin analítica
  • Sin phone-home

Open source:

  • Código fuente completo disponible en GitHub
  • Audita la seguridad tú mismo
  • Revisado por la comunidad

Mejores prácticas:

  • Cambia JWT_SECRET en producción
  • Usa un INITIAL_PASSWORD fuerte
  • Habilita HTTPS para despliegues en la nube
  • Rota las API keys regularmente

Lo que 9Router almacena:

  • Tokens OAuth de proveedores (cifrados)
  • API keys (cifradas)
  • Estadísticas de uso (solo locales)
  • Configuraciones de combos

Lo que 9Router NO almacena:

  • Tus prompts o respuestas
  • El código que generas
  • Información personal

¿Cómo actualizo 9Router?

Los métodos de actualización dependen del tipo de instalación:

Instalación global NPM

npm update -g 9router

Instalación local

cd 9router/app
git pull origin main
npm install
npm run build
npm start

Docker

docker pull 9router:latest
docker stop 9router
docker rm 9router
docker run -d \
  -p 3000:3000 \
  -v 9router-data:/app/data \
  9router:latest

Verificar versión:

9router --version

Cambios disruptivos:

  • Revisa CHANGELOG.md
  • Respalda ~/.9router antes de actualizaciones mayores
  • Revisa las guías de migración para versiones mayores

¿Cómo puedo contribuir?

¡Damos la bienvenida a las contribuciones!

Formas de contribuir:

  1. Reportar bugs:

  2. Solicitar características:

  3. Enviar código:

    # Fork del repo
    git clone https://github.com/YOUR_USERNAME/9router.git
    cd 9router
    
    # Crea una rama
    git checkout -b feature/your-feature
    
    # Haz cambios
    npm install
    npm run dev
    
    # Prueba
    npm test
    
    # Commit y push
    git add .
    git commit -m "Add your feature"
    git push origin feature/your-feature
    
    # Crea un Pull Request en GitHub
    
  4. Mejorar docs:

    • Corrige errores tipográficos, agrega ejemplos
    • Traduce a otros idiomas
    • Escribe tutoriales
  5. Agregar proveedores:

    • Implementa nuevos adaptadores de proveedores
    • Consulta app/lib/providers/ para ejemplos

Directrices de contribución:

  • Sigue el estilo de código existente
  • Agrega tests para nuevas características
  • Actualiza la documentación
  • Mantén los commits atómicos y descriptivos

Consulta CONTRIBUTING.md para detalles.


¿Necesitas más ayuda?