Conecta una API compatible con OpenAI
Muchos servicios y servidores de IA usan el mismo formato de API que OpenAI. atbridge.ai funciona con todos ellos mediante una sola opción de proveedor, OpenAI-compatible (URL personalizada). No tienes que instalar nada ni esperar a una integración: introduce la Base URL y la clave de API del servicio, y el atbridge Chat IA lo usa como cualquier otro proveedor.
Casos habituales:
- Un modelo en tu propio equipo o servidor: LM Studio, vLLM, el servidor de llama.cpp, LocalAI.
- Un proxy que gestiona tu empresa, por ejemplo LiteLLM delante de varios proveedores.
- Una pasarela de API o un revendedor que te da acceso a modelos mediante un endpoint compatible con OpenAI.
Qué necesitas
Sección titulada «Qué necesitas»- Base URL: la dirección de la API que indica la documentación de tu
proveedor. Es el mismo valor que el SDK de OpenAI llama
base_url, por ejemplohttps://llm.example.com/v1. Pégala tal como aparece en la documentación; atbridge.ai la acepta con o sin el/v1final. - Clave de API: se crea en el panel de tu proveedor. Un servidor local que no
comprueba claves acepta cualquier valor de relleno, como
local.
El servicio debe admitir dos endpoints estándar de OpenAI con autenticación
Authorization: Bearer: /v1/chat/completions (el chat en sí) y /v1/models
(la lista de modelos, que atbridge.ai también usa para comprobar la conexión).
Casi todos los servicios compatibles con OpenAI y servidores locales ofrecen
ambos.
Servidores locales habituales y su Base URL usual (comprueba tu propia configuración):
| Servidor | Base URL habitual |
|---|---|
| LM Studio | http://localhost:1234/v1 |
| vLLM | http://localhost:8000/v1 |
| llama.cpp server | http://localhost:8080/v1 |
| LiteLLM proxy | http://localhost:4000 |
Añádela a atbridge.ai
Sección titulada «Añádela a atbridge.ai»-
En Thunderbird, abre los Ajustes de atbridge: la rueda dentada, o Herramientas → Complementos y temas → atbridge.ai → Opciones (consulta Abrir los ajustes de la extensión atbridge). Ve a la pestaña Proveedores de IA.
-
En el desplegable Proveedor, elige OpenAI-compatible (URL personalizada).
-
Rellena Base URL y pega tu clave en Clave de API. La clave queda cifrada en este dispositivo y nunca llega a los servidores de atbridge.ai.
-
Haz clic en Conectar. atbridge.ai comprueba al momento la dirección y la clave pidiendo la lista de modelos. Si la comprobación es correcta, el estado cambia a un ✓ verde; si falla, no se guarda nada y ves el motivo.
Elige un modelo y chatea
Sección titulada «Elige un modelo y chatea»Abre el atbridge Chat IA (el botón @b en Thunderbird) y elige un modelo en el desplegable de modelos, que muestra los modelos que indica el servicio. Una pasarela puede listar cientos de modelos; para usar uno por su nombre exacto, escríbelo en id de modelo personalizado en Ajustes → Proveedor y modelo de IA preferidos.
Quién ve tus datos
Sección titulada «Quién ve tus datos»Con un proveedor compatible con OpenAI, tus prompts y cualquier texto de correo o adjunto que le des al Chat IA se envían a la Base URL que introdujiste. atbridge.ai no los reenvía ni los almacena. Antes de conectar un servicio, asegúrate de que confías en quien lo gestiona y lee sus condiciones de privacidad y de conservación de datos. Para el correo que no debe salir de tu equipo, usa un servidor local (la tabla anterior) u Ollama.
Configúralo desde la línea de comandos
Sección titulada «Configúralo desde la línea de comandos»La misma conexión desde un terminal; la clave se lee de la entrada estándar, así que no queda en el historial de tu shell:
echo "$MY_API_KEY" | atbridge connect activate --provider openai-compatible \ --base-url https://llm.example.com/v1 --key-stdinSi no se conecta
Sección titulada «Si no se conecta»- 404 o “not found”: la Base URL es incorrecta. Cópiala de nuevo de la
documentación del proveedor; normalmente es la dirección que termina en
/v1. - 401 o 403: la clave es incorrecta, ha caducado o no tiene acceso a ese modelo.
- La URL es correcta pero Conectar sigue fallando: puede que el servicio no
ofrezca la lista de modelos (
/v1/models), que atbridge.ai necesita para comprobar la conexión. Pregunta a tu proveedor si la admite. - El chat responde pero nunca consulta tu correo: el modelo no admite llamadas a herramientas. Elige otro modelo.
Relacionado
Sección titulada «Relacionado»Was this page helpful?
Thanks for the feedback!