QuantumNous/new-api

¿Qué es?

Funciones clave

• 01Ofrece endpoints compatibles con OpenAI, Anthropic Messages y Gemini para los mismos modelos externos
• 02Enruta solicitudes entre varios canales con asignaciones de modelos, prioridades, ponderaciones y reintentos
• 03Administra usuarios, grupos, claves de API y cuotas, con registros de uso y contabilidad de costos
• 04Admite OAuth/OIDC, passkeys y autenticación de dos factores para iniciar sesión en la consola
• 05Amplía las APIs asíncronas de imágenes, video y otras tareas mediante plugins de JavaScript

Casos de uso

• Compartir el acceso autorizado a modelos entre los miembros de un equipo, con cuotas por usuario y seguimiento del uso
• Cambiar de proveedor externo sin reconfigurar todas las aplicaciones cliente
• Ejecutar un servicio privado con varios modelos y una consola web para administradores

Inicio rápido

1. 1

   Inicia una instancia local con Docker (SQLite, vinculada a localhost).

   mkdir -p data docker run --name new-api -d --restart unless-stopped \ -p 127.0.0.1:3000:3000 \ -e TZ=Asia/Shanghai \ -v "$(pwd)/data:/data" \ calciumion/new-api:latest
2. 2

   Abre http://localhost:3000 y completa el asistente de configuración para crear la cuenta de administrador.

3. 3

   Añade un canal con tu clave de API upstream, configura los modelos y los precios y, después, crea una nueva clave de API.

4. 4

   Consulta los modelos disponibles con tu clave.

   curl --fail-with-body http://localhost:3000/v1/models \ -H "Authorization: Bearer ${NEW_API_KEY}"

Antes de usarlo

• !Debes aportar tus propias claves de API y cuentas upstream, y cumplir sus condiciones de uso.
• !Ofrecer públicamente o revender IA generativa o API conlleva importantes obligaciones legales, de registro y de cumplimiento normativo.
• !Licenciado bajo AGPL-3.0, una licencia copyleft que exige divulgar el código fuente cuando se usa a través de una red.

Temas

Preguntas frecuentes

¿Qué es new-api?

Gateway de IA autoalojado que ofrece APIs compatibles con OpenAI, Claude y Gemini para muchos proveedores de modelos, con enrutamiento, claves, cuotas y seguimiento de costos. New API es un gateway autoalojado que se interpone entre tus aplicaciones y servicios de modelos externos, como OpenAI, Anthropic, Google Gemini, Azure OpenAI, AWS Bedrock, Vertex AI y DeepSeek. Los clientes usan una API uniforme, y el gateway convierte entre los formatos de solicitud de OpenAI Chat/Responses, Anthropic Messages y Gemini.

¿new-api es gratuito? ¿Qué licencia tiene?

new-api es open source bajo la licencia AGPL-3.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.

¿new-api sigue mantenido?

Mantenimiento activo. El último commit de new-api fue el 19 oct 2026.

¿Para qué puedo usar new-api?

Compartir el acceso autorizado a modelos entre los miembros de un equipo, con cuotas por usuario y seguimiento del uso Cambiar de proveedor externo sin reconfigurar todas las aplicaciones cliente Ejecutar un servicio privado con varios modelos y una consola web para administradores

¿Cómo se instala new-api?

Inicia una instancia local con Docker (SQLite, vinculada a localhost).: mkdir -p data docker run --name new-api -d --restart unless-stopped \ -p 127.0.0.1:3000:3000 \ -e TZ=Asia/Shanghai \ -v "$(pwd)/data:/data" \ calciumion/new-api:latest Abre http://localhost:3000 y completa el asistente de configuración para crear la cuenta de administrador. Añade un canal con tu clave de API upstream, configura los modelos y los precios y, después, crea una nueva clave de API. Consulta los modelos disponibles con tu clave.: curl --fail-with-body http://localhost:3000/v1/models \ -H "Authorization: Bearer ${NEW_API_KEY}"

¿Dónde consigo new-api?

El código fuente y las instrucciones de instalación están en GitHub: https://github.com/QuantumNous/new-api