---
title: "Vercel AI SDK: createOpenAICompatible con URL base propia"
description: "Llame a BroadNet Inference desde el Vercel AI SDK con createOpenAICompatible de @ai-sdk/openai-compatible: generateText, streamText, herramientas y reasoning effort."
url: https://broadrouter.com/es/guides/vercel-ai-sdk-openai-compatible/
lang: es
updated: 2026-11-16
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/guides/vercel-ai-sdk-openai-compatible/) (actualizado el 2026-11-16).

# Cómo usar el Vercel AI SDK con BroadNet Inference

Actualizado 2026-11-16

Instale ai y @ai-sdk/openai-compatible, y llame a createOpenAICompatible con name broadnet, baseURL https://inference.broadnet.ai/v1 y su clave de BroadNet como apiKey. Pase al proveedor un ID de modelo de BroadNet como broadnet/glm-5.3 y use generateText o streamText como siempre. Mantenga la clave en el servidor y dé a los modelos de razonamiento un maxOutputTokens holgado.

El [AI SDK](https://ai-sdk.dev/providers/openai-compatible-providers) de Vercel es un kit de herramientas en TypeScript para aplicaciones con LLM. Su paquete `@ai-sdk/openai-compatible` crea un proveedor para cualquier API que siga el formato de chat completions de OpenAI. BroadNet Inference lo sigue, así que solo cambia la URL base, la clave y los IDs de modelo. Si prefiere el cliente de OpenAI sin más, consulte [la guía del SDK de Node](https://broadrouter.com/es/guides/openai-node-sdk/).

## Configuración

1.  **Instale los paquetes.** Al momento de escribir esto, npm ofrece `ai` 7.x y `@ai-sdk/openai-compatible` 3.x.
    
    ```bash
    npm install ai @ai-sdk/openai-compatible
    export BROADNET_API_KEY='your-broadnet-key'
    ```
    
2.  **Cree el proveedor.**
    
    ```ts
    // broadnet.ts
    import { createOpenAICompatible } from '@ai-sdk/openai-compatible';
    
    export const broadnet = createOpenAICompatible({
      name: 'broadnet',
      baseURL: 'https://inference.broadnet.ai/v1',
      apiKey: process.env.BROADNET_API_KEY,
      includeUsage: true, // usage data in streaming responses
    });
    ```
    
3.  **Genere texto.**
    
    ```ts
    import { generateText } from 'ai';
    import { broadnet } from './broadnet';
    
    const { text, usage, finishReason } = await generateText({
      model: broadnet('broadnet/glm-5.3'),
      prompt: 'Explain idempotency keys in two sentences.',
      maxOutputTokens: 4000, // reasoning counts toward this
    });
    
    console.log(text, finishReason, usage);
    ```
    
4.  **Haga streaming.** Cambie `generateText` por `streamText` y lea `textStream`. La [guía de streaming](https://broadrouter.com/es/guides/streaming-chat-completions/) explica el formato de transmisión que hay debajo.
    

El `name` que pase se convierte en la clave de las opciones y los metadatos del proveedor, así que manténgalo corto y estable. Tanto `provider('id')` como `provider.chatModel('id')` crean un modelo de chat; no hay configuración aparte por modelo. Mantenga la clave en el servidor. No importe este archivo en código que se ejecute en el navegador, o la clave llegará a cada visitante.

La documentación del proveedor enumera como capacidades admitidas la generación de texto, el streaming, las llamadas a herramientas, la salida estructurada, el contenido de razonamiento y la entrada de imágenes, con la nota de que algunas dependen del proveedor. En BroadNet, la entrada de imágenes funciona con DeepSeek V4.1 Flash, Qwen3.8 27B y Gemma 4 VL 26B. GLM 5.3 acepta solo texto.

## Opciones que conviene configurar

-   **reasoningEffort.** Páselo mediante `providerOptions`, con el nombre del proveedor como clave. La documentación del AI SDK indica que los valores exactos dependen del proveedor; la documentación de BroadNet muestra `low`.

```ts
const result = await generateText({
  model: broadnet('broadnet/deepseek-v4.1-flash'),
  prompt: 'Classify: "refund my order" -> intent?',
  providerOptions: { broadnet: { reasoningEffort: 'low' } },
});
```

-   **supportsStructuredOutputs.** El AI SDK solo envía esquemas JSON cuando este valor es `true` en el proveedor. BroadNet indica salida estructurada para GLM 5.3 y Qwen3.8 27B. Si lo activa, use esos modelos para la salida con esquema.
-   **maxRetries.** `generateText` reintenta dos veces de forma predeterminada. Ajústelo a su límite de frecuencia.
-   **Salida de razonamiento.** El AI SDK lee el contenido de razonamiento cuando el proveedor lo devuelve. El campo de resultado `reasoningText` de nivel superior ahora está marcado como obsoleto en favor de `finalStep.reasoningText`. No construya lógica que dependa de que el razonamiento esté presente.

## Qué modelo elegir

| Necesidad | Modelo | Contexto |
| --- | --- | --- |
| Llamadas a herramientas, salida estructurada | [`broadnet/glm-5.3`](https://broadrouter.com/es/models/glm-5.3/) | 1,048,576 |
| Imágenes con herramientas, árabe | [`broadnet/qwen3.8-27b`](https://broadrouter.com/es/models/qwen3.8-27b/) | 262,144 |
| Contexto largo, plan de tarifa plana | [`broadnet/deepseek-v4.1-flash`](https://broadrouter.com/es/models/deepseek-v4.1-flash/) | 1,048,576 |
| Llamadas de texto e imagen económicas | [`broadnet/gemma-4-26b-a4b`](https://broadrouter.com/es/models/gemma-4-vl-26b/) | 32,768 |

Los precios por token de cada modelo están en la [página de precios](https://broadrouter.com/es/pricing/).

## Solución de problemas

-   **401.** Falta `BROADNET_API_KEY` en el entorno de ejecución (revise las variables de entorno de su proveedor de hosting), o la clave es incorrecta, venció o se quedó sin saldo de pago por uso.
-   **Se ignoran las providerOptions.** La clave debe coincidir con el `name` del proveedor en camelCase. Con `name: 'broadnet'`, use `providerOptions.broadnet`.
-   **Errores del modelo.** El ID debe coincidir exactamente con el de BroadNet, con el prefijo `broadnet/`. GLM 5.3, Qwen3.8 27B y DeepSeek V4.1 Flash requieren una recarga; el crédito inicial de $5 cubre Gemma 4 VL 26B y los dos modelos Transcribe.
-   **Texto vacío, finishReason “length”.** El razonamiento agotó el presupuesto. Aumente `maxOutputTokens` o baje `reasoningEffort`. [Por qué las respuestas llegan vacías](https://broadrouter.com/es/guides/reasoning-tokens-empty-response/).
-   **429 bajo carga.** Una clave de pago por uso permite 30 solicitudes por minuto y 4 en curso. Las funciones serverless escalan rápido, así que limite la concurrencia en su aplicación. Consulte [errores y reintentos](https://broadrouter.com/es/guides/errors-and-retries/).
-   **Agentes en paralelo con una clave de plan.** Una [sesión de plan ilimitado](https://broadrouter.com/es/guides/unlimited-llm-api-sessions/) ejecuta una solicitud a la vez. Ejecutar `Promise.all` sobre varios agentes requiere una sesión por agente; si no, las solicitudes hacen fila.

## Términos de esta guía

[Llamadas a herramientas (tool calling)](https://broadrouter.com/es/glossary/tool-calling/)

Las llamadas a herramientas (tool calling), también llamadas function calling, son una función de las APIs de LLM en la que el modelo devuelve una solicitud estructurada para ejecutar una función definida por el desarrollador, con argumentos JSON. La aplicación ejecuta la función y devuelve el resultado; el modelo nunca ejecuta código.

[Streaming (respuestas en tiempo real)](https://broadrouter.com/es/glossary/streaming/)

El streaming es una forma de devolver la respuesta de un modelo de lenguaje en pequeños fragmentos mientras aún se genera, en lugar de una sola respuesta al final. Las APIs compatibles con OpenAI hacen streaming mediante server-sent events cuando la solicitud define stream como true.

[Pago por uso (pay-as-you-go)](https://broadrouter.com/es/glossary/pay-as-you-go/)

El pago por uso es un modelo de precios en el que usted paga solo lo que usa, medido por unidades como tokens, solicitudes o minutos de audio, sin suscripción ni compromiso mínimo. La mayoría de las APIs de LLM cobran así, desde un saldo prepagado o con una factura periódica.

[Concurrencia (concurrency)](https://broadrouter.com/es/glossary/concurrency/)

La concurrencia es el número de solicitudes que un cliente tiene en curso al mismo tiempo. Las APIs de LLM suelen limitarla por clave o por plan, aparte de las solicitudes por minuto, porque cada solicitud abierta ocupa capacidad de GPU hasta que su respuesta termina.

[Salida estructurada (structured output)](https://broadrouter.com/es/glossary/structured-output/)

La salida estructurada es una función de las APIs de LLM que restringe la respuesta del modelo a un formato que define el desarrollador, normalmente un JSON Schema, para que el código pueda procesarla de forma fiable. Es más estricta que JSON mode, que garantiza JSON válido pero no una forma concreta.

[Límite de frecuencia (rate limit)](https://broadrouter.com/es/glossary/rate-limit/)

Un límite de frecuencia (rate limit) es un tope que una API impone a cuánto puede usarla un cliente en un periodo, como solicitudes por minuto o tokens por minuto. Las solicitudes que lo superan se rechazan, normalmente con HTTP 429 Too Many Requests, hasta que el uso vuelve a quedar por debajo.

[API de Chat Completions](https://broadrouter.com/es/glossary/chat-completions-api/)

La API de Chat Completions es el endpoint HTTP de OpenAI, POST /v1/chat/completions, que recibe un nombre de modelo y una lista de mensajes etiquetados con su rol y devuelve el siguiente mensaje del modelo. Su forma de solicitud y respuesta se convirtió en el formato común que reutilizan los proveedores y SDKs compatibles con OpenAI.

[Crédito prepago (prepaid credit)](https://broadrouter.com/es/glossary/prepaid-credit/)

El crédito prepago es dinero que se añade a una cuenta de API antes de usarla. Cada solicitud descuenta su coste del saldo y, cuando el saldo se agota, las solicitudes medidas se detienen hasta que usted recargue. Limita el gasto a lo que ha pagado.

## Preguntas frecuentes

### ¿Uso @ai-sdk/openai o @ai-sdk/openai-compatible?

Use @ai-sdk/openai-compatible para APIs de terceros compatibles con OpenAI. Llama al endpoint de chat completions, que es lo que sirve BroadNet Inference.

### ¿Por qué el texto generado está vacío?

En BroadNet, el razonamiento cuenta para max\_tokens. Si maxOutputTokens es pequeño, el modelo puede agotarlo antes de empezar la respuesta. Auméntelo o ponga reasoningEffort en low.

### ¿Cómo obtengo el uso de tokens durante el streaming?

Ponga includeUsage en true al crear el proveedor. La documentación del AI SDK indica que agrega datos de uso a las respuestas en streaming. Su valor predeterminado es false.

### ¿Necesito una configuración aparte para cada modelo de BroadNet?

No. Un solo proveedor de createOpenAICompatible cubre todos los modelos. Llame a broadnet('model-id') o broadnet.chatModel('model-id') con cualquier ID de modelo de chat de BroadNet.

## Guías relacionadas

-   [Usar el SDK de OpenAI para Node.js con BroadNet Inference](https://broadrouter.com/es/guides/openai-node-sdk/)
-   [Streaming de chat completions y conexiones interrumpidas](https://broadrouter.com/es/guides/streaming-chat-completions/)
-   [¿Por qué un modelo de razonamiento devuelve una respuesta vacía?](https://broadrouter.com/es/guides/reasoning-tokens-empty-response/)
-   [Agregue BroadNet Inference a opencode como proveedor personalizado](https://broadrouter.com/es/guides/opencode-custom-provider/)
-   [Todas las herramientas que funcionan con BroadNet Inference (en inglés)](https://broadrouter.com/integrations/): SDK, agentes de programación, interfaces de chat y herramientas de automatización, con la configuración exacta de cada una

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-guides-vercel-ai-sdk-openai-compatible&utm_content=page-cta) ·

**Fuentes**

-   [Documentación del AI SDK, proveedores compatibles con OpenAI (consultada el 2026-11-14)](https://ai-sdk.dev/providers/openai-compatible-providers)
-   [Documentación del AI SDK, referencia de generateText (consultada el 2026-11-14)](https://ai-sdk.dev/docs/reference/ai-sdk-core/generate-text)
-   [npm, paquete @ai-sdk/openai-compatible (3.x, consultado el 2026-11-14)](https://www.npmjs.com/package/@ai-sdk/openai-compatible)
-   [Referencia de la API de BroadNet Inference (en inglés)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-guides-vercel-ai-sdk-openai-compatible&utm_content=sources)
