Conectar sus aplicaciones y herramientas a Xcellerate AIG: API compatible con OpenAI, Claude Code, Cursor y Copilot Studio

Cualquier aplicación, SDK o herramienta que hable con OpenAI puede hablar con Xcellerate AIG en cuanto cambie dos ajustes: la URL base y la clave API. Los equipos que usan los SDK de Anthropic, Google o AWS Bedrock pueden conservarlos, porque AIG responde en el formato de cada proveedor. Cada llamada recibe presupuestos, rate limits, guardrails, enrutamiento, failover y una entrada de registro.

TL;DR

• Cree una clave virtual por aplicación, equipo o agente.
• Apunte el cliente a la URL base adecuada: /v1, /anthropic, /genai, /bedrock o /v1/mcp.
• Compruebe la primera llamada en los registros. Las claves reales de sus proveedores nunca llegan a los clientes.

Antes de empezar

• Un administrador con permiso para crear claves virtuales (permiso Governance).
• Al menos un proveedor activado en AIG y un catálogo de modelos sincronizado.
• Acceso de red desde la aplicación a https://<your-gateway> (TLS, puerto 443).
• Un cliente que permita definir una URL base o un endpoint propios.

Conectar su aplicación o herramienta

1. Cree una clave virtual

Vaya a Govern → Governance → Virtual keys (Gobernar → Governance → Claves virtuales) y haga clic en New virtual key (Nueva clave virtual). Si quiere, limite proveedores y modelos y defina presupuesto, rate limit, caducidad (de 30 minutos a nunca), herramientas MCP y política de IP. Copie el token sk-xc-… enseguida: solo se muestra una vez.

2. Apunte el cliente a AIG

• Claude Code: defina ANTHROPIC_BASE_URL como https://<your-gateway>/anthropic y ANTHROPIC_AUTH_TOKEN como su clave virtual.
• Microsoft Copilot Studio: endpoint https://<your-gateway>/v1/mcp, autenticación «API key», cabecera Authorization: Bearer <virtual key>. Las herramientas aparecen como mcp__<server>__<tool>.

3. Use un nombre de modelo de AIG

Tome el nombre de Connect → Models (Conectar → Modelos), por ejemplo openai/gpt-4o-mini, o el nombre corto si es único.

4. Compruebe la primera llamada

Envíe una petición y abra Traffic → Logs (Tráfico → Registros). El filtro «Arrived as» muestra por qué punto de entrada llegó la llamada. Cada respuesta lleva el ID de petición en la cabecera x-xc-request-id.

Qué ocurre después de conectar

• GET /v1/models solo lista los modelos que esa clave puede llamar.
• /v1 cubre chat completions (también streaming), embeddings, generación de imágenes, voz, transcripción, rerank, models, responses, files, batches, feedback y MCP.
• El enrutamiento puede atender una petición con otro proveedor distinto del indicado; la respuesta mantiene el formato de quien llama.
• Cabeceras opcionales: x-xc-tags (p. ej. prod,checkout) para atribuir costes, x-xc-agent-name y x-xc-agent-run-id para líneas de tiempo de agentes, X-Request-Id y traceparent para enlazar con sus propios logs y trazas.

Conviene saber

• Las peticiones en streaming necesitan stream_options: {"include_usage": true} para poder tarificarse.
• Los clientes del SDK de Bedrock deben sustituir la cabecera SigV4 Authorization por la clave virtual, por ejemplo con un event hook de boto3. Solo se atienden invoke e invoke-with-response-stream.
• Las llamadas a funciones de Gemini llegan completas, no en streaming. Los flujos de Anthropic informan de los tokens de entrada al final.
• Los endpoints beta de los proveedores no están modelados. Existe un pass-through por clave y proveedor, desactivado por defecto.
• En modo gratuito: hasta 5 claves virtuales activas y 5 peticiones por clave al día.
• Las interfaces de chat como Open WebUI no tienen integración propia. Conéctelas como cualquier cliente compatible con OpenAI.

Solución de problemas

• 401 «Incorrect API key provided.» o «This API key has expired.»: la clave es desconocida, está revocada o ha caducado.
• 403 «This API key is not permitted to use the model '…'.»: el modelo queda fuera del alcance de la clave. Un bloqueo de guardrail también devuelve 403.
• 404 «The model '…' does not exist or you do not have access to it.»: revise el nombre en la pantalla Models.
• 402 o 429: se ha agotado el presupuesto o el rate limit de la clave; espere el tiempo de retry-after.

Los errores en /anthropic y /genai vuelven en el formato de error de ese proveedor.

Más información sobre una API para todos los modelos, las claves virtuales y los registros de peticiones.

¿Quiere que las herramientas de IA de su equipo pasen por una sola pasarela gobernada? Hable con nosotros sobre AIG.