---
title: "Spring AI: starter de OpenAI con base-url personalizada"
description: "Apunte el starter de chat OpenAI de Spring AI a BroadNet Inference con spring.ai.openai.base-url, un ID de BroadNet y max-tokens, y llámelo desde ChatClient."
url: https://broadrouter.com/es/guides/spring-ai-openai-base-url/
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/spring-ai-openai-base-url/) (actualizado el 2026-11-16).

# Spring AI con BroadNet Inference (base-url de OpenAI)

Actualizado 2026-11-16

Agregue spring-ai-starter-model-openai y luego ponga spring.ai.openai.base-url en https://inference.broadnet.ai/v1, spring.ai.openai.api-key en su clave de BroadNet y spring.ai.openai.chat.model en un ID de BroadNet como broadnet/glm-5.3. Defina spring.ai.openai.chat.max-tokens con margen para el razonamiento. Spring AI 2.x usa el SDK openai-java, que agrega /chat/completions a la URL base.

Spring AI es el framework del proyecto Spring para IA en Java. Su starter de chat de OpenAI lee una `base-url`, así que puede llamar a cualquier servidor compatible con OpenAI. BroadNet Inference sirve chat completions estándar en `https://inference.broadnet.ai/v1`. BroadRouter es el sitio de la propia BroadNet; esta guía sigue la referencia de Spring AI 2.0.2.

## Agregue el starter

Con el BOM de Spring AI configurado (vea la documentación de gestión de dependencias de Spring AI):

```xml
<dependency>
  <groupId>org.springframework.ai</groupId>
  <artifactId>spring-ai-starter-model-openai</artifactId>
</dependency>
```

## Configuración

`application.properties`:

```properties
spring.ai.openai.base-url=https://inference.broadnet.ai/v1
spring.ai.openai.api-key=${BROADNET_API_KEY}
spring.ai.openai.chat.model=broadnet/glm-5.3
spring.ai.openai.chat.max-tokens=2000
```

```bash
export BROADNET_API_KEY='your-broadnet-key'
```

Conserve `/v1` en la URL. En Spring AI 2.x el valor llega sin cambios al cliente openai-java (`OpenAiSetup.calculateBaseUrl` lo devuelve tal cual), y ese cliente agrega `/chat/completions`. El valor predeterminado que reemplaza es `https://api.openai.com/v1`.

## Llamada y prueba

```java
import org.springframework.ai.chat.client.ChatClient;
import org.springframework.boot.CommandLineRunner;
import org.springframework.context.annotation.Bean;

@Bean
CommandLineRunner smokeTest(ChatClient.Builder builder) {
    return args -> {
        ChatClient chat = builder.build();
        System.out.println(chat.prompt().user("Say hello in five words.").call().content());
    };
}
```

Inicie la aplicación. Si se imprime una respuesta, la clave, la URL y el ID de modelo son correctos.

## Ajustes que importan con BroadNet

-   **`max-tokens`, no `max-completion-tokens`.** La documentación de Spring AI dice que son mutuamente excluyentes y que definir ambos es un error. La referencia de la API de BroadNet describe `max_tokens`. DeepSeek V4.1 Flash, GLM 5.3 y Qwen3.8 27B razonan primero, y el razonamiento cuenta para el límite.
-   **Texto del razonamiento.** Spring AI puede exponer `reasoning_content` de servidores compatibles con OpenAI que lo devuelven. La referencia de la API de BroadNet reporta los recuentos de tokens de razonamiento en `usage`, pero no garantiza el texto del razonamiento en sí, así que no dependa de él.
-   **Sobrescritura solo para el chat.** `spring.ai.openai.chat.base-url` y `spring.ai.openai.chat.api-key` tienen prioridad sobre las propiedades compartidas para el modelo de chat. Úselas si otros modelos de OpenAI en Spring AI (como los embeddings) deben seguir en OpenAI.
-   **Reintentos.** `spring.ai.retry.max-attempts` vale 10 por defecto, con backoff exponencial. Con una clave de pago por uso eso puede agotar el límite por minuto; considere reducirlo.

## Qué modelo elegir

| Uso | `spring.ai.openai.chat.model` |
| --- | --- |
| Llamadas a herramientas, salida estructurada | `broadnet/glm-5.3` |
| Imágenes o texto en árabe | `broadnet/qwen3.8-27b` |
| Documentos largos, plan de tarifa plana | `broadnet/deepseek-v4.1-flash` |
| Crédito inicial gratuito | `broadnet/gemma-4-26b-a4b` |

[Precios de todos los modelos](https://broadrouter.com/es/pricing/).

## Solución de problemas

-   **401.** La clave es incorrecta, expiró o se quedó sin saldo, o `BROADNET_API_KEY` no está definida para la JVM.
-   **404.** A la URL base le falta `/v1`, o el ID del modelo es incorrecto. Los modelos de pago requieren una recarga; el crédito de $5 cubre solo `broadnet/gemma-4-26b-a4b` y los dos modelos Transcribe.
-   **`content()` vacío.** El razonamiento consumió el presupuesto de salida. Suba `max-tokens`. [Por qué las respuestas llegan vacías](https://broadrouter.com/es/guides/reasoning-tokens-empty-response/).
-   **400 con ambos límites de tokens definidos.** Quite `max-completion-tokens`.
-   **429.** Una clave de pago por uso permite 30 solicitudes por minuto y 4 simultáneas. Consulte [errores y reintentos](https://broadrouter.com/es/guides/errors-and-retries/).

## Términos de esta guía

[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.

[Token](https://broadrouter.com/es/glossary/token/)

Un token es la unidad de texto que un modelo de lenguaje lee y escribe: una palabra, parte de una palabra, un signo de puntuación o una secuencia de bytes producida por el tokenizador del modelo. Las APIs de LLM cuentan, limitan y normalmente facturan el uso en tokens.

[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.

[Embeddings (vectores de texto)](https://broadrouter.com/es/glossary/embeddings/)

Los embeddings son listas de números de punto flotante (vectores) que un modelo produce para representar un texto, una imagen u otra entrada. Las entradas de significado parecido obtienen vectores cercanos, así que la distancia entre vectores sirve para ordenar resultados de búsqueda, agrupar documentos o encontrar elementos relacionados.

[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.

[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.

[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.

[Backoff exponencial (exponential backoff)](https://broadrouter.com/es/glossary/exponential-backoff/)

El backoff exponencial es una estrategia de reintento en la que el cliente espera más tiempo tras cada intento fallido, normalmente duplicando la espera hasta un tope, antes de volver a intentarlo. Añadir jitter aleatorio a cada espera dispersa los reintentos de muchos clientes para que no lleguen al servidor en el mismo instante.

## Preguntas frecuentes

### ¿spring.ai.openai.base-url debe incluir /v1?

Sí. En Spring AI 2.x el valor se pasa sin cambios al cliente openai-java, cuyo valor predeterminado es https://api.openai.com/v1. Use https://inference.broadnet.ai/v1.

### ¿Debo usar max-tokens o max-completion-tokens con BroadNet?

max-tokens. La documentación de Spring AI dice que ambos son mutuamente excluyentes. La referencia de la API de BroadNet describe el campo max\_tokens, y el razonamiento cuenta para él, así que permita 1,000 tokens o más.

### ¿Funcionan las llamadas a herramientas de Spring AI con BroadNet?

Use GLM 5.3 o Qwen3.8 27B, que BroadNet indica con herramientas. La documentación de BroadNet no indica llamadas a herramientas para DeepSeek V4.1 Flash.

### ¿Puedo mantener OpenAI para embeddings y usar BroadNet para el chat?

Sí. spring.ai.openai.chat.base-url y spring.ai.openai.chat.api-key tienen prioridad sobre las propiedades compartidas solo para el modelo de chat. La referencia de la API de BroadNet no incluye un endpoint de embeddings.

## Guías relacionadas

-   [Llame a BroadNet Inference desde Go con el SDK openai-go](https://broadrouter.com/es/guides/openai-go-sdk/)
-   [Usar el SDK de OpenAI para Python con BroadNet Inference](https://broadrouter.com/es/guides/openai-python-sdk/)
-   [¿Por qué un modelo de razonamiento devuelve una respuesta vacía?](https://broadrouter.com/es/guides/reasoning-tokens-empty-response/)
-   [Códigos de error de BroadNet Inference y cuándo reintentar](https://broadrouter.com/es/guides/errors-and-retries/)
-   [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-spring-ai-openai-base-url&utm_content=page-cta) ·

**Fuentes**

-   [Referencia de Spring AI, OpenAI Chat (2.0.2) (consultada el 2026-11-15)](https://docs.spring.io/spring-ai/reference/api/chat/openai-chat.html)
-   [Código fuente de Spring AI en v2.0.2, OpenAiSetup.calculateBaseUrl (consultado el 2026-11-16)](https://github.com/spring-projects/spring-ai/blob/v2.0.2/models/spring-ai-openai/src/main/java/org/springframework/ai/openai/setup/OpenAiSetup.java)
-   [Referencia de la API de BroadNet Inference (consultada el 2026-11-15) (en inglés)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-guides-spring-ai-openai-base-url&utm_content=sources)
