---
title: "¿Qué es una API compatible con OpenAI? Cómo funciona"
description: "Una API compatible con OpenAI acepta las mismas solicitudes que OpenAI: los SDKs funcionan cambiando la URL base, la clave y el modelo. Qué coincide y qué no."
url: https://broadrouter.com/es/glossary/openai-compatible-api/
lang: es
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traducido del inglés con ayuda de IA. [Lea el original en inglés](https://broadrouter.com/glossary/openai-compatible-api/) (actualizado el 2026-11-15).

# API compatible con OpenAI

Actualizado 2026-11-15

Una API compatible con OpenAI es una API HTTP que acepta los mismos formatos de solicitud y respuesta que la API de OpenAI, como POST /v1/chat/completions, de modo que los SDKs y herramientas de OpenAI pueden usarla cambiando solo la URL base, la clave de API y el nombre del modelo.

También llamado: API compatible con OpenAI, API estilo OpenAI, reemplazo directo de OpenAI, compatible con la API de OpenAI, OpenAI-compatible API, OpenAI API compatible, OpenAI-style API, OpenAI drop-in replacement

El formato de la API de OpenAI se convirtió en el idioma común de las herramientas de LLM. Muchos proveedores ya lo aceptan, así que una sola biblioteca cliente puede comunicarse con muchos backends.

## Cómo funciona

Una API compatible copia las partes de la API de OpenAI de las que dependen los clientes:

-   las mismas rutas, como `/v1/chat/completions` y `/v1/audio/transcriptions`;
-   los mismos formatos JSON: un arreglo `messages` de entrada, `choices[0].message.content` de salida y un bloque `usage` con los conteos de tokens;
-   una [clave de API](https://broadrouter.com/es/glossary/api-key/) enviada como `Authorization: Bearer <key>`;
-   [streaming](https://broadrouter.com/es/glossary/streaming/) como server-sent events cuando `stream` es true.

Cambiar de proveedor es un cambio de configuración. Con el SDK oficial para Python:

```python
from openai import OpenAI
import os

client = OpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"])
reply = client.chat.completions.create(
    model="broadnet/gemma-4-26b-a4b",
    messages=[{"role": "user", "content": "Say hello in Arabic."}],
)
print(reply.choices[0].message.content)
```

Solo cambiaron tres valores respecto de un ejemplo de OpenAI: la [URL base](https://broadrouter.com/es/glossary/base-url/), la clave y el ID del modelo.

## Por qué importa

La compatibilidad reduce el costo de cambiar. Los SDKs, frameworks de agentes, plugins de IDE y [routers](https://broadrouter.com/es/glossary/llm-router/) que hablan el formato de OpenAI funcionan sin código nuevo. Puede probar un segundo proveedor en minutos y mantener la opción de migrar.

Pero compatible no significa idéntico. La propia capa de compatibilidad de Anthropic, por ejemplo, ignora `strict` en las herramientas y deja vacío `prompt_tokens_details`. Diferencias típicas:

-   parámetros que se ignoran o se rechazan;
-   cómo cuentan los [tokens de razonamiento](https://broadrouter.com/es/glossary/reasoning-tokens/) para `max_tokens`;
-   si el uso se informa al final de un stream;
-   límites de frecuencia y códigos de error.

## En BroadNet Inference

BroadNet Inference ofrece `POST /v1/chat/completions`, `POST /v1/audio/transcriptions` y `GET /v1/models` en `https://inference.broadnet.ai/v1`. Las claves solo se envían como `Authorization: Bearer <key>`. Las guías de [Python](https://broadrouter.com/es/guides/openai-python-sdk/) y [Node](https://broadrouter.com/es/guides/openai-node-sdk/) muestran configuraciones completas, y [LangChain](https://broadrouter.com/es/guides/langchain-openai-base-url/) funciona de la misma manera.

Hay dos diferencias que debe planificar: DeepSeek V4.1 Flash, GLM 5.3 y Qwen3.8 27B razonan antes de responder, y el razonamiento cuenta para `max_tokens`. Además, una clave de pago por uso permite 30 solicitudes por minuto y 4 simultáneas. La [lista de verificación para migrar](https://broadrouter.com/es/blog/openai-compatible-api-migration-checklist/) cubre el resto.

## Errores comunes

-   Mantener un nombre de modelo de OpenAI como `gpt-6-astra` (el modelo insignia de OpenAI en su página de modelos, consultada el 2026-11-15). Use el ID de modelo del proveedor.
-   Suponer que un parámetro funciona porque la solicitud tuvo éxito. Algunos proveedores ignoran en silencio los campos desconocidos.

## Preguntas frecuentes

### ¿Compatible con OpenAI significa que funcionan todas las funciones de OpenAI?

No. Significa que los formatos básicos de solicitud y respuesta coinciden. Algunos campos pueden ignorarse o rechazarse. La capa de compatibilidad de Anthropic, por ejemplo, documenta campos que ignora y otros que devuelven un error 400. Lea la lista del proveedor antes de depender de un parámetro.

### ¿Necesito otro SDK?

No. Los SDKs oficiales de OpenAI aceptan una URL base personalizada. En Python pase base\_url, en Node pase baseURL, o configure la variable de entorno OPENAI\_BASE\_URL.

### ¿Qué endpoints admite BroadNet Inference?

POST /v1/chat/completions para chat y POST /v1/audio/transcriptions para voz a texto. También existe GET /v1/models; la documentación de BroadNet lo describe como metadatos públicos del catálogo para monitores externos, así que tome de la referencia de la API los IDs de modelo para sus solicitudes.

## Vea también

-   [URL base (base URL)](https://broadrouter.com/es/glossary/base-url/) (término)
-   [Clave de API (API key)](https://broadrouter.com/es/glossary/api-key/) (término)
-   [Router de LLM (LLM router)](https://broadrouter.com/es/glossary/llm-router/) (término)
-   [Streaming (respuestas en tiempo real)](https://broadrouter.com/es/glossary/streaming/) (término)
-   [Proveedor de inferencia (inference provider)](https://broadrouter.com/es/glossary/inference-provider/) (término)
-   [Server-sent events (SSE)](https://broadrouter.com/es/glossary/sse/) (término)
-   [API de Chat Completions](https://broadrouter.com/es/glossary/chat-completions-api/) (término)
-   [Usar el SDK de OpenAI para Python con BroadNet Inference](https://broadrouter.com/es/guides/openai-python-sdk/) (guía)
-   [Usar el SDK de OpenAI para Node.js con BroadNet Inference](https://broadrouter.com/es/guides/openai-node-sdk/) (guía)
-   [Cómo usar LangChain con BroadNet Inference](https://broadrouter.com/es/guides/langchain-openai-base-url/) (guía)
-   [Primera solicitud a BroadNet Inference con curl](https://broadrouter.com/es/guides/curl-quickstart/) (guía)
-   [Cambiar a una API compatible con OpenAI: lista de verificación](https://broadrouter.com/es/blog/openai-compatible-api-migration-checklist/) (artículo)
-   [OpenRouter o tarifa plana para agentes de IA: ¿qué cuesta menos?](https://broadrouter.com/es/blog/openrouter-alternative-flat-rate/) (artículo)

Pruébelo con su carga de trabajo real. Las cuentas nuevas empiezan con USD 5 de crédito para Gemma y transcripción. DeepSeek, GLM y Qwen3.8 requieren una recarga.

[Comenzar](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-glossary-openai-compatible-api&utm_content=page-cta) ·

**Fuentes**

-   [Referencia de la API de OpenAI, crear un chat completion](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
-   [Anthropic, compatibilidad con el SDK de OpenAI y sus limitaciones](https://platform.claude.com/docs/en/api/openai-sdk)
-   [SDK de OpenAI para Python (base\_url y OPENAI\_BASE\_URL)](https://github.com/openai/openai-python)
-   [Referencia de la API de BroadNet Inference (en inglés)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-glossary-openai-compatible-api&utm_content=sources)
-   [OpenAI, modelos (consultado el 2026-11-15)](https://developers.openai.com/api/docs/models)
