BroadRouter

URL base de APIs compatibles con OpenAI: 14 proveedores verificados

Por el equipo de BroadNet Inference · 6 min de lectura · Publicado

Una API compatible con OpenAI le permite conservar el SDK de OpenAI y cambiar solo dos cosas: base_url y la clave de API. La URL base varía según el proveedor, por ejemplo https://api.groq.com/openai/v1 para Groq, https://openrouter.ai/api/v1 para OpenRouter y https://inference.broadnet.ai/v1 para BroadNet Inference. Las rutas, los IDs de modelo y los parámetros admitidos siguen siendo distintos, así que pruebe una solicitud antes de cambiar.

Una API compatible con OpenAI acepta solicitudes con la misma estructura que la API de OpenAI, de modo que los SDK oficiales de OpenAI funcionan en cuanto usted cambia base_url y la clave de API. Lo difícil es que cada proveedor coloca su endpoint en un sitio ligeramente distinto. La tabla siguiente recoge 14, cada uno tomado de la documentación del propio proveedor el 15 de noviembre de 2026.

¿Cuál es la URL base de cada proveedor compatible con OpenAI?

Proveedor URL base Qué incluye su documentación de compatibilidad con OpenAI Particularidades que indica la documentación
OpenAI https://api.openai.com/v1 Todo; es la referencia Valor predeterminado del SDK si no se configura nada
Anthropic https://api.anthropic.com/v1/ Chat completions “Primarily intended to test and compare model capabilities” (Traducción: «pensada principalmente para probar y comparar las capacidades de los modelos»); strict se ignora; las entradas de audio y archivos devuelven 400
Google Gemini https://generativelanguage.googleapis.com/v1beta/openai/ Chat completions, embeddings, generación de imágenes, modelos, batch Soporte de la biblioteca de OpenAI “still in beta” (Traducción: «todavía en beta»); no figura la Responses API
DeepSeek https://api.deepseek.com Chat completions Sin ruta de versión; URL aparte con formato de Anthropic en /anthropic
Groq https://api.groq.com/openai/v1 Chat completions, Responses API; notas sobre transcripción de audio logprobs, logit_bias, top_logprobs y messages[].name devuelven 400; n debe ser 1; sin transcripciones srt ni vtt
Together AI https://api.together.ai/v1 Chat, completions, imágenes, voz, transcripciones, modelos, Responses Inferencia solo en EE. UU. en https://us-api.together.ai/v1; embeddings solo en endpoints dedicados
Fireworks AI https://api.fireworks.ai/inference/v1 Chat completions IDs de modelo como accounts/fireworks/models/…; reduce max_tokens para que quepa en el contexto en lugar de devolver un error, salvo que se indique lo contrario
DeepInfra https://api.deepinfra.com/v1/openai Chat completions; los clientes de Responses usan la misma base Embeddings, imágenes y voz documentados en otra página
Mistral AI https://api.mistral.ai/v1 POST /v1/chat/completions Su referencia de la API no se declara compatible con OpenAI; pruébela antes de depender de ella
OpenRouter https://openrouter.ai/api/v1 Chat completions Cabeceras opcionales HTTP-Referer y X-OpenRouter-Title para sus rankings
xAI https://api.x.ai/v1 Responses API Su guía dice “The Responses API is the preferred way of interacting with our models” (Traducción: «La Responses API es la forma preferida de interactuar con nuestros modelos»)
Z.ai (GLM) https://api.z.ai/api/paas/v4/ Chat completions Ruta v4, no v1
Alibaba Model Studio https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 (Singapur) Chat completions ID del espacio de trabajo en el host; una clave solo funciona en la región donde se creó, de lo contrario devuelve 401
BroadNet Inference https://inference.broadnet.ai/v1 Chat completions, transcripción de audio Los IDs de modelo empiezan por broadnet/; vea más abajo

Alibaba también incluye un endpoint en EE. UU. (Virginia) en us-east-1. Su fila de Pekín, en la misma página, muestra el host de Singapur, mientras que otro texto de esa página menciona cn-beijing, así que confirme en la consola cualquier endpoint de China. La tabla es una instantánea. Los endpoints cambian: la documentación de Anthropic y la de Google redirigieron a nuevas direcciones mientras las revisábamos.

Para comparar precios entre estos proveedores, consulte las páginas de precios de API de LLM por proveedor.

¿Cómo se configura la URL base en el código?

En Python, pase base_url al cliente:

import os
from openai import OpenAI

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

En Node, la opción se llama baseURL:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://inference.broadnet.ai/v1",
  apiKey: process.env.BROADNET_API_KEY,
});

O bien configúrela una sola vez para todas las herramientas que usan los SDK oficiales. En el código fuente del SDK para Node, baseURL toma por defecto process.env['OPENAI_BASE_URL'] y, si no existe, https://api.openai.com/v1; el README de Python documenta la misma variable:

export OPENAI_BASE_URL="https://inference.broadnet.ai/v1"
export OPENAI_API_KEY="your-key"

Guías completas: SDK de OpenAI para Python, SDK de OpenAI para Node. Para saber qué es una URL base y por qué las herramientas la piden, consulte el glosario.

¿Cómo se prueba una nueva URL base con curl?

Envíe una solicitud mínima antes de modificar el código de su aplicación:

curl https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "broadnet/gemma-4-26b-a4b", "messages": [{"role": "user", "content": "ping"}], "max_tokens": 20}'

Sustituya la URL base, la clave y el modelo por los del proveedor que esté probando. Un 200 con un array choices significa que la ruta, la clave y el ID de modelo son correctos. Un 404 suele indicar una ruta incorrecta; un 401, que la clave o la región no son las correctas; un 400 a menudo nombra el parámetro que el proveedor rechaza. La guía rápida de curl tiene más ejemplos, y el generador de solicitudes de API le escribe las versiones para curl, Python y Node.

¿Cuáles son los errores más comunes al cambiar base_url?

  • Pegar el endpoint completo. El SDK añade /chat/completions. Una URL base que ya termina así produce /chat/completions/chat/completions y un 404.
  • Añadir o quitar /v1 por costumbre. La base documentada de DeepSeek no lleva /v1, la de Z.ai termina en /v4/ y la de Gemini en /v1beta/openai/. Copie la cadena exacta del proveedor.
  • Mantener los nombres de modelo de OpenAI. Los nombres gpt-… fallan en otros proveedores. Cada uno tiene su propio formato: deepseek-ai/DeepSeek-V4-Flash-0731 en DeepInfra, accounts/fireworks/models/… en Fireworks, broadnet/deepseek-v4.1-flash en BroadNet.
  • Enviar parámetros que el proveedor rechaza o ignora. Groq devuelve 400 con logprobs; la capa de Anthropic ignora sin avisar seed, logit_bias y reasoning_effort. Un parámetro ignorado en silencio es peor que un error, porque nada se lo advierte.
  • Suponer que los campos de la respuesta son los mismos. La capa de Anthropic devuelve prompt_tokens_details vacío, así que falta el informe de tokens en caché. Fireworks coloca el uso del streaming en el último fragmento, algo que los tipos del SDK quizá no declaren.
  • Suponer que existen todos los endpoints. «Compatible con OpenAI» suele significar chat completions. Embeddings, audio, generación de imágenes y la Responses API son cuestiones aparte, como muestra la tabla.
  • Mezclar regiones. Las claves de Alibaba están ligadas a una región, y Together ofrece un host aparte solo para EE. UU. Una clave válida en el host equivocado también falla.

La lista completa para antes del cambio está en la lista de verificación para migrar a una API compatible con OpenAI.

¿Qué endpoints admite BroadNet Inference?

La referencia de la API de BroadNet documenta dos endpoints de modelos en https://inference.broadnet.ai/v1, además de GET /v1/models para los metadatos del catálogo:

Endpoint Modelos
POST /v1/chat/completions DeepSeek V4.1 Flash, GLM 5.3, Qwen3.8 27B, BroadNet Gemma 4 VL 26B
POST /v1/audio/transcriptions BroadNet Transcribe Arabic, BroadNet Transcribe (14 idiomas)

Qué significa esto en la práctica:

  • No hay embeddings, generación de imágenes ni Responses API documentados. Una herramienta que necesite alguno de ellos requiere un segundo proveedor para esa parte.
  • La llamada a herramientas y la salida estructurada están documentadas para GLM 5.3 y Qwen3.8 27B.
  • Las imágenes se envían como URLs data: dentro de partes de contenido image_url, en DeepSeek V4.1 Flash, Qwen3.8 27B y Gemma 4 VL 26B.
  • Los modelos de razonamiento (DeepSeek V4.1 Flash, GLM 5.3, Qwen3.8 27B) cuentan el razonamiento dentro de max_tokens. Deje 1,000 tokens o más, o configure reasoning_effort en low, como recomienda la documentación; consulte por qué los modelos de razonamiento devuelven respuestas vacías.
  • Una lista de modelos respondió cuando llamamos a GET /v1/models el 15 de noviembre de 2026, pero no figura en la lista de endpoints documentados, así que no construya nada sobre ella.
  • Los límites de las claves de pago por uso son 30 solicitudes por minuto y 4 simultáneas.

Precios por 1M de tokens: DeepSeek V4.1 Flash $0.175 de entrada y $0.52 de salida; Gemma 4 VL 26B $0.10 y $0.22. DeepSeek V4.1 Flash también se vende como plan de tarifa plana a $60 al mes por sesión, con una solicitud a la vez.

¿Conviene enrutar varios proveedores a través de una sola URL base?

Si su aplicación llama a varios de estos proveedores, un proxy como LiteLLM le da a su código una sola URL base y asigna los nombres de modelo a cada proveedor de origen. Usted define esa asignación; nada cambia de proveedor por usted a menos que configure las alternativas (fallbacks) por su cuenta. Failover de API de LLM muestra cómo hacerlo, en un cliente o en LiteLLM. La guía del proxy de LiteLLM muestra una entrada para BroadNet. Para más contexto sobre el término, consulte API compatible con OpenAI.

Dónde encaja BroadNet Inference

BroadNet encaja bien si su código ya usa chat completions y usted busca modelos abiertos, voz a texto en árabe y en varios idiomas, o una sesión de DeepSeek con tarifa plana en una sola clave. No encaja si necesita embeddings, la Responses API o generación de imágenes del mismo proveedor; Together AI y Gemini documentan una parte mayor de la superficie de OpenAI. Contraste nuestra tabla con la documentación de cada proveedor antes de pasar a producción, porque estas URLs y listas de endpoints cambian.

Preguntas frecuentes

¿Cuál es la URL base de la API de OpenAI?

https://api.openai.com/v1. El SDK oficial para Node la usa cuando usted no configura ni baseURL ni la variable de entorno OPENAI_BASE_URL.

¿La base_url debe terminar en /v1 o en /chat/completions?

Termínela donde la termine la documentación del proveedor, normalmente en /v1. El SDK añade /chat/completions por su cuenta, así que una URL base que ya termina en /chat/completions produce un 404.

¿Puedo definir la URL base con una variable de entorno?

Sí. Los dos SDK oficiales de OpenAI leen OPENAI_BASE_URL, y muchas herramientas basadas en ellos también. Defina OPENAI_API_KEY junto a ella y revise la documentación de cada herramienta, porque algunas usan nombres de variable propios.

¿La API de Claude es compatible con OpenAI?

En parte. Anthropic ofrece https://api.anthropic.com/v1/ para el SDK de OpenAI, pero indica que esa capa sirve sobre todo para probar y comparar modelos, no como vía de producción a largo plazo. Ignora strict en las herramientas y rechaza entradas de audio y de archivos.

¿Qué endpoints admite BroadNet Inference?

Su documentación incluye POST /v1/chat/completions y POST /v1/audio/transcriptions. No incluye embeddings, generación de imágenes ni la Responses API.

¿Por qué mi solicitud funciona con OpenAI pero falla con otro proveedor?

Normalmente por un ID de modelo con el formato equivocado o por un parámetro que el proveedor rechaza. Groq, por ejemplo, devuelve 400 con logprobs, logit_bias, top_logprobs y messages[].name. Quite los parámetros opcionales y vuelva a intentarlo con el ID de modelo exacto del proveedor.

Leer en MarkdownPreguntar a ChatGPTPreguntar a ClaudePreguntar a Perplexity