Saltar al contenido principal
Zubnet AI › Aprender › Wiki › API compatible con OpenAI
Infraestructura

API compatible con OpenAI

También conocido como: OpenAI-Compatible API, Endpoint compatible con OpenAI, API de Chat Completions
Una API que copia el formato de solicitud y respuesta del endpoint Chat Completions de OpenAI, de modo que el código cliente de OpenAI existente funciona con otros modelos cambiando solo la URL base.

Por qué importa

La compatibilidad elimina la mayor parte del costo de cambiar. Una aplicación, un framework de agentes o un plugin de editor escrito para OpenAI se puede apuntar a un modelo local, a un proveedor más barato o a un servidor autoalojado sin reescribir código. Eso hace fácil comparar modelos, evitar la dependencia de un proveedor y mover las cargas de trabajo adonde el precio y la calidad sean mejores.

También es la razón por la que las herramientas locales funcionan con tanto software sin configuración adicional. Cualquier aplicación con un ajuste de «endpoint de OpenAI personalizado» puede hablar con Ollama, LM Studio o vLLM.

En profundidad

Cuando OpenAI lanzó su API de Chat Completions en 2023, su formato pronto se convirtió en el estándar contra el que programaban la mayoría de los desarrolladores y las herramientas: un POST a /v1/chat/completions con un nombre de modelo y una lista de messages, cada uno con un role (system, user o assistant) y un content. Otros proveedores y servidores de código abierto descubrieron que la forma más fácil de ganar adopción era aceptar el mismo formato.

El resultado es un estándar de facto. Un servidor «compatible con OpenAI» habla este protocolo aunque el modelo que está detrás no tenga nada que ver con OpenAI. Para cambiarte, modificas dos ajustes en tu cliente: la URL base y la clave de API.

Cómo se ve

from openai import OpenAI

client = OpenAI(
    base_url="http://localhost:11434/v1",  # Ollama, or any compatible server
    api_key="not-needed-locally",
)

response = client.chat.completions.create(
    model="llama3.2",
    messages=[{"role": "user", "content": "Explain KV caching in one sentence."}],
)
print(response.choices[0].message.content)

El mismo código funciona contra un servidor distinto cambiando base_url y model.

Quién la soporta

  • Servidores locales y autoalojados: vLLM, Ollama (localhost:11434/v1), LM Studio (localhost:1234/v1), el servidor de llama.cpp y SGLang.
  • Proveedores de inferencia: Together AI, Fireworks AI, Groq, Cerebras, DeepSeek, Mistral, xAI y muchos otros.
  • Agregadores y pasarelas: OpenRouter y LiteLLM exponen cientos de modelos a través de un solo endpoint compatible.
  • Otros grandes laboratorios: Google ofrece un endpoint compatible con OpenAI para Gemini, y Anthropic ofrece una capa de compatibilidad pensada sobre todo para pruebas.

Dónde se rompe la compatibilidad

«Compatible» normalmente significa que lo básico funciona: mensajes de entrada, texto de salida, streaming. Más allá de eso, espera diferencias.

  • Llamadas a herramientas: el formato es en su mayor parte compartido, pero la confiabilidad, las llamadas en paralelo y el streaming de los argumentos de las herramientas varían según el servidor y el modelo.
  • Salida estructurada: response_format con un esquema JSON está soportado por algunos servidores, parcialmente por otros e ignorado por unos pocos.
  • Razonamiento: no hay un campo acordado para los tokens de pensamiento. Los proveedores los devuelven en lugares distintos, o no los devuelven.
  • Funciones específicas del proveedor: los controles de prompt caching, las citas y la búsqueda web integrada a menudo no encajan en el formato de OpenAI, así que el endpoint compatible expone menos que la API nativa del proveedor.
  • Parámetros y errores: los parámetros no soportados pueden descartarse en silencio, el uso de tokens puede reportarse de otra forma y los códigos de error no son consistentes.

La regla práctica: para chat simple, confía en la compatibilidad. Para cualquier cosa avanzada, prueba la función exacta contra el servidor exacto, y usa la API nativa cuando necesites todas las capacidades de un proveedor.

Un estándar en movimiento

La propia OpenAI ya dio el siguiente paso. En 2025 presentó la Responses API como su interfaz recomendada, con herramientas integradas y estado de conversación del lado del servidor, mientras sigue dando soporte a Chat Completions. La mayor parte del ecosistema todavía apunta a Chat Completions, aunque algunos servidores han empezado a agregar soporte para Responses. Mientras tanto, la API Messages de Anthropic se ha vuelto un segundo formato común, y varios proveedores ahora ofrecen también endpoints compatibles con Anthropic, en buena medida para que los agentes de codificación puedan correr sobre sus modelos.

Así que «compatible con OpenAI» se lee mejor como «habla Chat Completions», un mínimo común denominador que no va a desaparecer pronto.

← Todos los términos
ESC