Saltar al contenido principal

Gestión de proveedores

Rephlo se conecta a varios proveedores de IA a la vez. Puedes usar un plan alojado de Rephlo para el trabajo diario, tu propia cuenta de OpenAI para tareas generales, una cuenta de Anthropic para documentos largos y un modelo local de Ollama para datos privados, todo configurado en paralelo.

Dos formas de acceder a la IA

1. Rephlo Gateway (recomendado para usuarios nuevos)

El Rephlo Gateway (la Dedicated API) es la forma más fácil de empezar. En lugar de gestionar tus propias claves de API, accedes a los modelos de IA a través de tu suscripción de Rephlo.

Ventajas:

  • Sin gestión de claves de API — solo tienes que iniciar sesión con tu cuenta de Rephlo.
  • Facturación unificada — una sola suscripción cubre varios modelos de IA, con seguimiento en forma de credits.
  • Modelos preconfigurados — modelos populares disponibles sin necesidad de configuración.
  • Actualizaciones automáticas — se añaden nuevos modelos por ti.

Para usar el Gateway:

  1. Abre la sección Account y usa Sign In para iniciar sesión con tu cuenta de Rephlo.
  2. Una vez que hayas iniciado sesión, el proveedor Gateway se configura automáticamente y sus modelos quedan disponibles.

El proveedor Gateway se gestiona a través de tu cuenta — no lo añades ni lo eliminas manualmente de la lista de proveedores. Consulta Account y Billing & Subscription.

¿Prefieres usar solo BYOK o modelos on-device? Activa Hide online models from Rephlo Gateway en Settings > LLM Providers — el interruptor está disponible tanto en la subpestaña On-Device como en BYOK Providers. Esto oculta los modelos de Gateway (Dedicated API) en todos los selectores de modelo: la barra de estado, el chat y la superposición. Si un modelo de Gateway es tu modelo activo cuando lo activas, Rephlo te cambia automáticamente a un modelo on-device o BYOK accesible, en lugar de dejarte silenciosamente en el que ahora está oculto.

2. BYOK (trae tu propia clave)

Para quienes prefieren tener control directo o ya cuentan con suscripciones con el proveedor, Rephlo se conecta directamente a los proveedores de IA usando tus propias claves de API.

Ventajas:

  • Relación directa con el proveedor — pagas directamente al proveedor.
  • Control total — accede a todos los modelos y funciones que ofrece el proveedor.
  • Endpoints personalizados — conéctate a implementaciones privadas, empresariales o autoalojadas.

Proveedores compatibles (BYOK)

Cuando añades un proveedor, eliges uno de estos tipos:

ProveedorVisiónNotas
OpenAIModelos de la familia GPT; endpoint personalizado opcional
AnthropicModelos Claude; admite prompt caching
Google AIModelos Gemini
Grok (xAI)Modelos Grok; Live Search (web) opcional
GroqVaríaInferencia rápida para modelos abiertos
OpenRouterVaríaPuerta de enlace a muchos modelos de distintos proveedores
OllamaVaríaModelos locales/sin conexión; clave opcional para búsqueda web
OpenAI-CompatibleVaríaCualquier servicio compatible con la especificación de OpenAI — Azure OpenAI, vLLM, LocalAI, LiteLLM, proxies personalizados

Azure OpenAI se conecta mediante el tipo OpenAI-Compatible (apuntándolo a tu endpoint de Azure), y no como una entrada independiente en la lista para añadir proveedores. Ollama se explica en detalle en la página dedicada Modelos on-device.

Añadir un proveedor

  1. Ve a Settings > Providers.
  2. Haz clic en Add Provider.
  3. Select Type — elige el proveedor en el menú desplegable.
  4. Enter details (los campos cambian según el tipo que elijas):
    • Name — un alias descriptivo (por ejemplo, "My GPT", "Work Claude").
    • API Key — tu clave secreta del panel del proveedor.
    • Base URL — para OpenAI-Compatible y Ollama, la URL del endpoint.
    • Model Name — el modelo que se va a usar (obligatorio para OpenAI-Compatible y varios otros).
  5. Test Connection — valida la configuración antes de guardar (ver más abajo).
  6. Save.

Campos específicos de cada proveedor

Cada tipo de proveedor pide lo que necesita:

ProveedorObligatorioOpcional
OpenAIAPI KeyBase URL personalizada
AnthropicAPI KeyBase URL; opciones de prompt caching
Google AIAPI KeyBase URL
Grok (xAI)API KeyInterruptor de Live Search
GroqAPI Key
OpenRouterAPI KeySite URL, Site Name (para el panel de actividad de OpenRouter)
OllamaBase URL (por defecto http://localhost:11434)Clave de API (solo para búsqueda web)
OpenAI-CompatibleAPI Key, Base URL, Model Name

Prompt Caching de Anthropic

Cuando añades un proveedor Anthropic, verás las opciones de prompt caching:

  • Enable Prompt Caching — activado por defecto. El almacenamiento en caché puede reducir mucho el costo del contexto repetido.
  • Cache TTLephemeral (unos 5 minutos) o extended (aproximadamente 1 hora). Un TTL más largo tiene un costo de escritura más alto, pero mantiene el contexto en caché durante más tiempo.
  • Cache Logging — registro detallado opcional del rendimiento de la caché.

El almacenamiento en caché solo se activa cuando una solicitud realmente incluye contexto reutilizable (por ejemplo, cuando hay un Space adjunto a un chat). Consulta Prompt Caching para ver el panorama completo.

Probar la conexión

El botón Test Connection valida tu configuración antes de guardar:

Un resultado verde significa que las credenciales y el endpoint funcionan; un resultado rojo muestra qué salió mal para que puedas corregirlo.

Parámetros del modelo

Una vez configurado un modelo, puedes ajustar cómo genera texto:

  • Temperature — valores más bajos para respuestas precisas y deterministas, valores más altos para respuestas creativas y variadas.
  • Max tokens — limita la longitud de la respuesta.
  • Top-p / sampling — control fino sobre la aleatoriedad (cuando el modelo lo admite).

Rephlo aplica rangos de parámetros adecuados a cada modelo, así que no puedes establecer valores que un modelo no acepte.

Varios modelos por proveedor

Un mismo proveedor puede tener varios modelos. En el panel Add/Edit Provider puedes:

  • Add Model — registrar otro modelo bajo el mismo proveedor, cada uno con sus propios parámetros.
  • Set Active Model — marcar qué modelo usa ese proveedor por defecto.
  • Edit / Remove modelos individuales.

Esto permite que una sola conexión de Anthropic u OpenRouter cubra, por ejemplo, un modelo rápido para el trabajo diario y un modelo más potente para problemas difíciles, sin tener que configurar el proveedor dos veces.

Capacidades del proveedor

Al añadir o editar un proveedor puedes marcar qué capacidades admite. Estas determinan lo que está disponible en Chat y en los commands:

  • Vision — habilita Visual Intelligence para capturar y analizar capturas de pantalla, fotos, diagramas y mensajes de error.
  • Function Calling — llama a herramientas externas (necesario para los MCP Connectors).
  • Long Context — gestiona entradas grandes.
  • Code Generation — optimizado para tareas de programación.
  • Streaming — las respuestas aparecen progresivamente en tiempo real.

Por ejemplo, necesitas un proveedor con capacidad Vision para usar las funciones de Visual Intelligence (capturas de pantalla, diagramas, mensajes de error), y un modelo con capacidad Function Calling para usar connectors en el chat.

Configurar el proveedor activo

Puedes designar un proveedor activo que se use de forma predeterminada en todos los commands.

  • El proveedor activo ejecuta todos los commands, a menos que un command concreto lo anule.
  • Para cambiarlo, haz clic en Activate junto al proveedor que prefieras en la lista.
  • El proveedor activo aparece resaltado en la interfaz.
  • Solo puede haber un proveedor activo a la vez.

Obtener claves de API (BYOK)

Con BYOK, pagas directamente al proveedor por el uso. Obtén las claves desde la consola de cada proveedor:

  • OpenAIplatform.openai.com
  • Anthropicconsole.anthropic.com
  • Google AIaistudio.google.com
  • Grok (xAI)console.x.ai
  • Groqconsole.groq.com
  • OpenRouteropenrouter.ai
  • Ollama (clave de búsqueda web)ollama.com/settings/keys

Configurar modelos locales (Ollama)

Para ejecutar modelos completamente sin conexión:

  1. Instala Ollama.
  2. Descarga un modelo desde la terminal, por ejemplo ollama pull llama3.
  3. En Rephlo, añade un proveedor Ollama.
  4. Base URLhttp://localhost:11434 (por defecto).
  5. Model — escribe el nombre exactamente como aparece en Ollama (por ejemplo, llama3:latest).
  6. (Opcional) añade una clave de búsqueda web de Ollama para habilitar la búsqueda web.

Para modelos GGUF on-device y comprobaciones de hardware, consulta Modelos on-device.

Funciones de la interfaz de proveedores

La página Providers te ayuda a gestionar muchas conexiones:

  • Search — busca proveedores por nombre.
  • View toggle — cambia entre la vista de tarjetas y la vista de lista.
  • Status indicators — comprueba de un vistazo qué proveedores están configurados, activos o con errores.

Solución de problemas con proveedores

  • 401 Unauthorized — es probable que la clave de API sea incorrecta. Vuelve a copiarla desde el proveedor y prueba de nuevo.
  • 429 Too Many Requests — has alcanzado el límite de solicitudes del proveedor o te has quedado sin credits.
  • Connection Refused (Ollama) — asegúrate de que el servicio en segundo plano de Ollama esté en ejecución.
  • Model Not Found — comprueba que el ID del modelo esté bien escrito y disponible en tu cuenta.
  • Test fails after import on a new computer — las claves cifradas no se pueden trasladar entre equipos; vuelve a introducir la clave. Consulta Import & Export.

Relacionado: Modelos on-device · Prompt Caching · Configuración de proveedores

Próxima función: Aprende las distintas formas de ejecutar Commands.