Endpoints remotos

Piixie es local-first, y usar un modelo remoto es una decisión deliberada. Cuando configuras un endpoint, el texto del documento se envía a ese proveedor durante la anonimización. Para los pros y los contras, consulta privacidad.

Los endpoints remotos tienen sentido cuando el hardware local es demasiado lento, cuando quieres la calidad de detección de un modelo de frontera, o cuando tu organización ejecuta un servidor de inferencia compartido (consulta Piixie como servidor local).

Añadir un endpoint

En ajustes, abre la sección de endpoints de IA y añade un endpoint:

1. Protocol: una de tres formas de API
   • Anthropic (Messages API)
   • OpenAI chat (Chat Completions, también el protocolo para la mayoría de servidores autoalojados: llama.cpp, Ollama, vLLM, un servidor Piixie)
   • OpenAI responses (la OpenAI Responses API)
2. Name: una etiqueta, mostrada junto a los modelos del endpoint en el selector de modelos
3. Base URL: sin ningún sufijo /v1; Piixie añade las rutas de la API por su cuenta
4. API key: obligatoria para proveedores comerciales, opcional para endpoints autoalojados

Elegir modelos

Haz clic en Fetch models y Piixie consulta al endpoint su lista de modelos. Cada fila de modelo tiene:

• Un interruptor enable: solo los modelos habilitados aparecen en el selector de modelos
• Un display name que puedes editar
• Una marca de vision, detectada automáticamente a partir del ID del modelo y modificable. Los modelos con visión habilitada reciben imágenes renderizadas para el análisis de imágenes; los demás reciben solo texto.

Habilita los pocos modelos que realmente usas en lugar de toda la lista. El selector de modelos fusiona los modelos locales y remotos en un solo menú, y una lista corta lo mantiene manejable.

Usar un modelo remoto

Elige el modelo remoto en el selector de modelos. La primera vez que seleccionas un modelo en la nube, Piixie muestra una confirmación de que el contenido del documento se enviará a esa API remota y saldrá de tu equipo; “don’t ask again” la suprime por endpoint. Todo lo demás queda igual: los mismos modos, los mismos perfiles, el mismo diálogo de progreso en streaming, los mismos registros de historial. El streaming funciona en los tres protocolos.

Una nota sobre claves y almacenamiento

Las configuraciones de endpoint, incluidas las API keys, se guardan en la base de datos local SQLite de Piixie en tu equipo. Las claves se envían solo a la base URL del endpoint.