Conectar OpenAI, Anthropic, Gemini, Mistral, Groq u OpenRouter a Xcellerate AIG

Al conectar OpenAI, Anthropic, Google Gemini, Mistral, Groq u OpenRouter a Xcellerate AIG, su equipo obtiene un único punto de acceso controlado a los modelos de IA alojados. Sus aplicaciones llaman a AIG con su propia clave virtual y nunca ven la clave del proveedor. Esta guía es para administradores de MSP, pymes y empresas de servicios.

En resumen

• La configuración es igual para los seis proveedores: elija el tipo, póngale nombre y pegue una clave API.
• Un proveedor nuevo empieza desactivado, así que primero lo prueba con una sola solicitud pequeña.
• Tras activarlo, sincronice el catálogo de modelos y emita una clave virtual para cada aplicación.

Antes de empezar

• Una cuenta con el proveedor y una clave API estándar: clave de OpenAI, clave de la consola de Anthropic, clave de Google AI Studio (API de Gemini) o clave de Mistral, Groq u OpenRouter.
• El rol Admin en AIG, o un rol personalizado con permiso para crear y editar proveedores.
• Tráfico HTTPS saliente desde el servidor de AIG hacia el proveedor. Las direcciones por defecto son api.openai.com/v1, api.anthropic.com/v1, generativelanguage.googleapis.com/v1beta, api.mistral.ai/v1, api.groq.com/openai/v1, openrouter.ai/api/v1. Si el tráfico debe pasar por un proxy, configúrelo en General settings → Network egress (ajustes generales → tráfico de red saliente).

Configurar el proveedor

1. Inicie el asistente

En la barra lateral, vaya a Connect → Providers (Conectar → Proveedores) y haga clic en Connect a provider (conectar un proveedor).

2. Elija el proveedor y póngale nombre

En Provider type (tipo de proveedor), elija OpenAI, Anthropic, Google Gemini, Mistral, Groq u OpenRouter. Asigne un Display name (nombre visible) que todos reconozcan, por ejemplo «OpenAI producción». Deje Base URL (URL base) vacío para usar la dirección por defecto del proveedor.

3. Pegue la clave API

Pegue la clave en el campo API key (clave API). AIG guarda el proveedor desactivado, así que todavía no le llega tráfico.

4. Pruebe

Con Try it (probar), envíe una solicitud real pequeña. También puede elegir Continue anyway (continuar de todos modos); el proveedor queda entonces desactivado. Más adelante, Test connection (probar conexión) hace la misma comprobación.

5. Active, sincronice y emita una clave

Haga clic en Enable provider (activar proveedor). Después cargue el catálogo de modelos con Models → Sync (Modelos → Sincronizar) y cree una clave para su aplicación en Governance → Virtual keys → New virtual key (nueva clave virtual).

Opcional: más claves, alcance más limitado

• Con Add key (añadir clave) puede poner varias claves del proveedor en un mismo proveedor y dar a cada una un Weight (peso) para repartir el tráfico.
• Limite una clave a ciertos modelos con Allowed models (modelos permitidos).
• En What this provider serves (qué ofrece este proveedor), marque solo lo que necesite.

Qué ocurre después de conectar

Sus aplicaciones indican un modelo como <nombre-del-proveedor>/<modelo>, por ejemplo openai/gpt-4o-mini, o con un nombre de modelo sin prefijo que AIG resuelve a través del catálogo. AIG traduce cada solicitud al formato del proveedor, de modo que una misma solicitud de estilo OpenAI puede llegar a OpenAI, Anthropic o Gemini.

La sincronización del catálogo obtiene nombres de modelos, ventanas de contexto y precios de una ficha de datos publicada, según una programación (como máximo una vez por hora) o bajo demanda.

Qué ofrece cada tipo:

• OpenAI: chat, embeddings, imágenes, voz, transcripción, rerank
• Anthropic: chat
• Google Gemini: chat, embeddings
• Mistral: chat, embeddings, transcripción
• Groq: chat, transcripción, voz
• OpenRouter: chat, embeddings, imágenes

Conviene saber

• Max retries (número máximo de reintentos) es 0 por defecto. Active los reintentos de forma deliberada.
• Con varias claves, AIG las rota automáticamente. Una clave rechazada se marca como Dead o Suspect; una clave limitada por uso muestra Cooling down y vuelve sola.
• Desactivar un proveedor detiene el tráfico desde la siguiente solicitud y conserva sus claves. Eliminar un proveedor elimina también sus claves.
• Las solicitudes de estilo OpenAI en streaming solo se valoran si quien llama envía stream_options: {"include_usage": true}.
• Las claves API son de solo escritura: tras guardarlas solo verá una pista enmascarada como sk-…4f2a, y las claves del proveedor nunca aparecen en los mensajes de error.
• Sin licencia, AIG funciona en modo gratuito: 5 claves virtuales con 5 solicitudes por clave y día. Una licencia elimina ese límite.

Solución de problemas

• «No enabled key to test with.» Añada una clave o active la existente y vuelva a probar.
• «No model to try. Sync the catalog first…» Ejecute Models → Sync e inténtelo de nuevo.
• <model> did not answer (<ms> ms): <message> El mensaje viene del proveedor. Compruebe la clave y si su cuenta tiene acceso a ese modelo.
• No healthy API key is available for provider '…' (503) o Every API key configured for '…' failed for this request. (502): revise el estado de las claves (Healthy, Dead, Cooling down, Suspect), corrija la clave y haga clic en Clear health flags (borrar indicadores de estado). No enabled provider is configured for '…' (400) significa que ningún proveedor activado coincide con ese nombre.

Hable con nosotros sobre AIG

¿Quiere ver cómo encaja AIG en su MSP o empresa de servicios? Hable con nosotros sobre AIG. Más información sobre todos los proveedores en un catálogo y las claves virtuales.