Al desarrollar aplicaciones de IA o prototipar flujos de trabajo agentes, frecuentemente necesitamos experimentar con múltiples modelos de lenguaje grandes para encontrar la opción óptima. Sin embargo, debido a que diferentes proveedores utilizan estructuras de API y protocolos distintos, cambiar entre ellos suele requerir una tediosa refactorización de código y constantes actualizaciones en la lógica de tu backend.
AIClient2API aborda exactamente este desafío. Actúa como una capa de proxy inteligente que simula las solicitudes de clientes de plataformas como Gemini CLI, Antigravity, Codex, Grok y Kiro, encapsulándolas en una interfaz de API única, estandarizada y compatible con OpenAI. Además de la unificación de protocolos, proporciona un panel de interfaz web para monitorear el estado en vivo de cada nodo.
Características Principales
- Intercambio de modelos sin costo: Escribe tu código de integración una vez usando formatos estándar del SDK de OpenAI y cambia de proveedor de backend dinámicamente sin modificar tu lógica de negocio.
- Consola de gestión visual: Incluye un panel de interfaz web para la gestión de configuración en tiempo real, monitoreo del estado de salud, pruebas de API mediante un Playground integrado y auditoría de registros de solicitudes.
Arquitectura técnica e implementación
El proyecto se basa en una arquitectura modular orientada a IA construida sobre Node.js para manejar la traducción de protocolos y mantener una alta disponibilidad:
plaintext1[ Tu aplicación (Cherry-Studio / Cline / Código personalizado) ] 2 │ (Solicitud estándar de OpenAI / Claude) 3 ▼ 4 ┌─────────────────────────────┐ 5 │ AIClient2API Gateway │ 6 └──────────────┬──────────────┘ 7 │ 8 ┌─────────────┴─────────────┐ 9 ▼ ▼ 10 ┌──────────────┐ ┌──────────────┐ 11 │ Adaptadores │ │ Pool de │ 12 │ │ │ proveedores │ 13 └───────┬──────┘ └───────┬──────┘ 14 │ │ (Verificación de salud / Enfriamiento) 15 ▼ ▼ 16 ┌──────────────┐ ┌──────────────┐ 17 │ TLS Sidecar │ │ Failover y │ 18 │ (Go uTLS) │ │ respaldo │ 19 └───────┬──────┘ └───────┬──────┘ 20 │ │ 21 └─────────────┬─────────────┘ 22 ▼ 23 [ Backends: Gemini, Grok, Kiro...]
1. Patrones de Estrategia y Adaptador
Cuando una solicitud llega al gateway, el sistema identifica el proveedor de modelo objetivo y la enruta a través de un adaptador de servicio específico. El adaptador traduce los payloads estándar de OpenAI o Claude a la estructura exacta requerida por el cliente upstream (como la estructura interna de Gemini CLI o los endpoints de Grok), manejando sin problemas tanto respuestas estándar como de streaming (text/event-stream).
2. Pools inteligentes de proveedores y cadenas de respaldo
Para garantizar una fiabilidad de nivel de producción, el proxy gestiona un pool de cuentas y endpoints:
- Verificaciones automáticas de salud y enfriamiento: El sistema realiza latidos (heartbeats) periódicos. Si un nodo falla o activa un límite de 429 (Demasiadas solicitudes), se coloca en una cola de enfriamiento temporal y se evita automáticamente.
- Respaldo entre tipos: Si un tipo de proveedor se queda sin cuota, el gateway puede redirigir las solicitudes a través de una cadena de respaldo preconfigurada (por ejemplo, pasando de gemini-cli-oauth a gemini-antigravity) siempre que los protocolos coincidan.
3. Mimicry de huella TLS (TLS Sidecar)
Ciertos servicios upstream aplican estrictas verificaciones de red y bloquean solicitudes que no coinciden con las huellas dactilares TLS de los navegadores. Para resolver esto, el proyecto incorpora un proxy TLS Sidecar escrito en Go (usando uTLS). Emula los handshakes TLS estándar de Chrome y maneja automáticamente la negociación HTTP/2 para prevenir errores 403 Forbidden.
Integración en el ecosistema: Soporte nativo de AtlasCloud
En actualizaciones recientes, AIClient2API introdujo soporte nativo para AtlasCloud, una plataforma de inferencia de IA multimodal todo en uno.
AtlasCloud agrupa modelos altamente rentables como Qwen 3.6, DeepSeek v4 pro, Kimi k2.6 y GLM 5.1 bajo un único endpoint. La integración de AtlasCloud en tu pool de AIClient2API ofrece ventajas específicas:
- Cambio fluido y rendimiento estable: Puedes alternar entre las capacidades de razonamiento de DeepSeek, el procesamiento de lenguaje de Qwen y la generación multimodal sin fricciones. La infraestructura empresarial subyacente garantiza tasas de concurrencia estables.
- Plantillas listas para usar: El repositorio incluye ajustes preestablecidos de configuración en junto con rutas de enrutador dedicadas, lo que te permite comenzar a trabajar de inmediato.text
1provider_pools.json.example
Esta configuración es altamente beneficiosa para los desarrolladores que participan en el Plan de Codificación económico de AtlasCloud para minimizar los costos operativos de infraestructura.
Primeros pasos
- Despliegue mediante Docker:
- Bash
plaintext1docker run -d -p 3000:3000 -p 8085-8086:8085-8086 -p 1455:1455 -p 19876-19880:19876-19880 --restart=always -v "tu_ruta/configs:/app/configs" --name aiclient2api justlikemaki/aiclient-2-api
- Configuración vía Interfaz Web: Accede a http://localhost:3000 (contraseña predeterminada: admin123) para añadir tus credenciales y gestionar tus proveedores visualmente.
- Enruta tu tráfico: Apunta tu cliente de escritorio de IA o SDK de backend preferido a tu instancia de gateway local.
Para obtener detalles completos de implementación, documentación y opciones de configuración avanzada, visita el repositorio de GitHub.
