Repolode
Enviar
fruitbars

fruitbars/simple-one-api

Gateway autohospedado que ofrece acceso a varios proveedores de LLM mediante endpoints compatibles con OpenAI, Responses y Anthropic, distribuido como un único ejecutable.

Alternativa open source a:OpenRouter

Ver en GitHub
Estrellas
2,344
Forks
209
Issues abiertos
47
Último commit
el mes pasado

¿Qué es?

simple-one-api es un gateway que se sitúa entre las herramientas cliente y varios proveedores de modelos de lenguaje grandes. Los clientes se conectan a un único endpoint mediante los protocolos OpenAI Chat Completions, OpenAI Responses o Anthropic Messages, mientras el gateway dirige las solicitudes a proveedores configurados como Qianfan, iFlytek Spark, Tencent Hunyuan, MiniMax y DeepSeek.

Cada proveedor puede tener un pool con varias API keys. El gateway estima el costo en tokens de cada solicitud, controla una ventana móvil de capacidad de 60 segundos por clave y modelo, y cambia a otra clave cuando un servicio upstream devuelve un 429. La consola de administración muestra los tiempos de espera y recuperación. Los límites de velocidad se pueden configurar en los niveles de proveedor, modelo del proveedor, clave y modelo de la clave.

El proyecto se distribuye como un único binario que incluye un chat web en React, una consola de configuración con SQLite, una vista de estadísticas de uso y una aplicación de escritorio Wails que ejecuta un gateway local en loopback. También está disponible en archivos de GitHub Releases y como imagen Docker para varias arquitecturas.

Funciones clave

  • 01Ofrece endpoints OpenAI Chat Completions, Responses y Anthropic Messages desde un único gateway.
  • 02Agrupa varias API keys por proveedor y permite enrutarlas de forma round-robin, preferente, aleatoria o mediante hash.
  • 03Estima la capacidad de tokens por clave y recurre a otra clave si el servicio upstream responde con un 429.
  • 04Aplica límites por capas de QPS, QPM, RPM, TPM y concurrencia.
  • 05Incluye un chat web integrado y una consola de configuración con el estado de las claves en tiempo real.
  • 06Guarda la configuración en SQLite y ofrece estadísticas de uso sin almacenar el contenido de los prompts ni de las respuestas.

Casos de uso

  • Compartir una clave de gateway entre varios clientes locales, como Codex o Claude Code.
  • Distribuir el tráfico intenso entre varias claves upstream para reducir los errores 429.
  • Ejecutar un punto de acceso privado y autohospedado a varios proveedores chinos de LLM.
  • Ofrecer a un equipo pequeño un único endpoint compatible con OpenAI y visibilidad del uso.

Inicio rápido

  1. 1

    Compila el ejecutable único desde el código fuente

    ./quick_build.sh
  2. 2

    Ejecuta el gateway; no necesitas config.json para la configuración inicial

    ./simple-one-api
  3. 3

    Abre http://localhost:9090/ en un navegador y completa el asistente de /setup

Antes de usarlo

  • Para compilar desde el código fuente necesitas Go 1.25 o posterior, Node.js y pnpm.
  • Los precios, las cuotas gratuitas y los detalles de los modelos dependen de los proveedores upstream y pueden cambiar, por lo que el README recomienda consultar su documentación oficial.

En colecciones

Apps autoalojadas

Temas

#llm-gateway#openai-compatible#api-proxy#load-balancing#rate-limiting#self-hosted#golang

Preguntas frecuentes

¿Qué es simple-one-api?
Gateway autohospedado que ofrece acceso a varios proveedores de LLM mediante endpoints compatibles con OpenAI, Responses y Anthropic, distribuido como un único ejecutable. simple-one-api es un gateway que se sitúa entre las herramientas cliente y varios proveedores de modelos de lenguaje grandes. Los clientes se conectan a un único endpoint mediante los protocolos OpenAI Chat Completions, OpenAI Responses o Anthropic Messages, mientras el gateway dirige las solicitudes a proveedores configurados como Qianfan, iFlytek Spark, Tencent Hunyuan, MiniMax y DeepSeek.
¿simple-one-api es gratuito? ¿Qué licencia tiene?
simple-one-api es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿simple-one-api sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de simple-one-api fue el 29 sept 2026.
¿Para qué puedo usar simple-one-api?
Compartir una clave de gateway entre varios clientes locales, como Codex o Claude Code. Distribuir el tráfico intenso entre varias claves upstream para reducir los errores 429. Ejecutar un punto de acceso privado y autohospedado a varios proveedores chinos de LLM. Ofrecer a un equipo pequeño un único endpoint compatible con OpenAI y visibilidad del uso.
¿Cómo se instala simple-one-api?
Compila el ejecutable único desde el código fuente: ./quick_build.sh Ejecuta el gateway; no necesitas config.json para la configuración inicial: ./simple-one-api Abre http://localhost:9090/ en un navegador y completa el asistente de /setup
¿Dónde consigo simple-one-api?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/fruitbars/simple-one-api

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados