---
title: "Spring AI: starter OpenAI con base-url personalizzata"
description: "Punta lo starter chat OpenAI di Spring AI su BroadNet Inference con spring.ai.openai.base-url, un ID di modello BroadNet e max-tokens, poi chiamalo da ChatClient."
url: https://broadrouter.com/it/guides/spring-ai-openai-base-url/
lang: it
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Tradotto dall’inglese con l’aiuto dell’IA. [Leggi l’originale in inglese](https://broadrouter.com/guides/spring-ai-openai-base-url/) (aggiornato il 2026-11-16).

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

Aggiornato 2026-11-16

Aggiungi spring-ai-starter-model-openai, poi imposta spring.ai.openai.base-url su https://inference.broadnet.ai/v1, spring.ai.openai.api-key sulla tua chiave BroadNet e spring.ai.openai.chat.model su un ID BroadNet come broadnet/glm-5.3. Imposta spring.ai.openai.chat.max-tokens lasciando spazio al ragionamento. Spring AI 2.x usa l’SDK openai-java, che aggiunge /chat/completions alla base URL.

Spring AI è il framework del progetto Spring per l’AI in Java. Il suo starter chat OpenAI legge una `base-url`, quindi può chiamare qualsiasi server compatibile con OpenAI. BroadNet Inference serve chat completions standard su `https://inference.broadnet.ai/v1`. BroadRouter è il sito di BroadNet; questa guida segue il riferimento di Spring AI 2.0.2.

## Aggiungere lo starter

Con il BOM di Spring AI già configurato (vedi la documentazione di Spring AI sulla gestione delle dipendenze):

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

## Configurazione

`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'
```

Mantieni `/v1` nell’URL. In Spring AI 2.x il valore arriva invariato al client openai-java (`OpenAiSetup.calculateBaseUrl` lo restituisce così com’è), ed è quel client ad aggiungere `/chat/completions`. Il default che sostituisci è `https://api.openai.com/v1`.

## Chiamarlo e testarlo

```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());
    };
}
```

Avvia l’app. Se viene stampata una risposta, chiave, URL e ID del modello sono corretti.

## Impostazioni che contano per BroadNet

-   **`max-tokens`, non `max-completion-tokens`.** La documentazione di Spring AI dice che si escludono a vicenda e che impostarli entrambi è un errore. Il riferimento API di BroadNet descrive `max_tokens`. DeepSeek V4.1 Flash, GLM 5.3 e Qwen3.8 27B ragionano prima di rispondere, e il ragionamento conta nel limite.
-   **Testo del ragionamento.** Spring AI può esporre `reasoning_content` dai server compatibili con OpenAI che lo restituiscono. Il riferimento API di BroadNet riporta il conteggio dei token di ragionamento in `usage` ma non garantisce il testo del ragionamento, quindi non farci affidamento.
-   **Override solo per la chat.** `spring.ai.openai.chat.base-url` e `spring.ai.openai.chat.api-key` hanno la precedenza sulle proprietà condivise per il modello di chat. Usale se altri modelli OpenAI di Spring AI (come gli embedding) devono restare su OpenAI.
-   **Retry.** `spring.ai.retry.max-attempts` vale 10 per default, con backoff esponenziale. Con una chiave a consumo può esaurire il limite al minuto; valuta di abbassarlo.

## Quale modello scegliere

| Uso | `spring.ai.openai.chat.model` |
| --- | --- |
| Tool calling, output strutturato | `broadnet/glm-5.3` |
| Immagini o testo in arabo | `broadnet/qwen3.8-27b` |
| Documenti lunghi, piano a prezzo fisso | `broadnet/deepseek-v4.1-flash` |
| Credito iniziale gratuito | `broadnet/gemma-4-26b-a4b` |

[Prezzi di tutti i modelli](https://broadrouter.com/it/pricing/).

## Risoluzione dei problemi

-   **401.** La chiave è sbagliata, scaduta o ha esaurito la quota, oppure `BROADNET_API_KEY` non è impostata per la JVM.
-   **404.** Alla base URL manca `/v1`, oppure l’ID del modello è sbagliato. I modelli a pagamento richiedono una ricarica; il credito di $5 copre solo `broadnet/gemma-4-26b-a4b` e i due modelli Transcribe.
-   **`content()` vuoto.** Il ragionamento ha consumato il budget di output. Alza `max-tokens`. [Perché le risposte arrivano vuote](https://broadrouter.com/it/guides/reasoning-tokens-empty-response/).
-   **400 con entrambi i limiti di token impostati.** Rimuovi `max-completion-tokens`.
-   **429.** Una chiave a consumo consente 30 richieste al minuto e 4 in corso contemporaneamente. Vedi [errori e retry](https://broadrouter.com/it/guides/errors-and-retries/).

## Termini in questa guida

[Pagamento a consumo (pay-as-you-go)](https://broadrouter.com/it/glossary/pay-as-you-go/)

Il pagamento a consumo è un modello di prezzo in cui paghi solo ciò che usi, misurato per unità come token, richieste o minuti di audio, senza abbonamento né impegno minimo. La maggior parte delle API LLM fattura così, da un saldo prepagato o con una fattura periodica.

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

Un token è l’unità di testo che un modello linguistico legge e scrive: una parola, una parte di parola, un segno di punteggiatura o una sequenza di byte prodotta dal tokenizer del modello. Le API LLM contano, limitano e di solito fatturano l’uso in token.

[Base URL (URL di base)](https://broadrouter.com/it/glossary/base-url/)

La base URL è l’indirizzo radice fisso di un’API, come https://api.example.com/v1, che un client antepone a ogni percorso di endpoint, come /chat/completions. Negli SDK compatibili con OpenAI, cambiare la base URL, insieme alla chiave API e all’ID del modello, punta lo stesso codice verso un altro provider.

[Concorrenza (concurrency)](https://broadrouter.com/it/glossary/concurrency/)

La concorrenza è il numero di richieste che un client ha in corso nello stesso momento. Le API LLM spesso la limitano per chiave o per piano, separatamente dalle richieste al minuto, perché ogni richiesta aperta occupa capacità GPU finché la sua risposta non è terminata.

[Rate limit (limite di frequenza)](https://broadrouter.com/it/glossary/rate-limit/)

Un rate limit è un tetto che un’API pone a quanto un client può usarla in un intervallo di tempo, per esempio richieste al minuto o token al minuto. Le richieste oltre il limite vengono rifiutate, di solito con HTTP 429 Too Many Requests, finché l’uso non torna sotto la soglia.

[Tool calling (chiamata di strumenti)](https://broadrouter.com/it/glossary/tool-calling/)

Il tool calling, detto anche function calling, è una funzionalità delle API LLM in cui il modello restituisce una richiesta strutturata di eseguire una funzione definita dallo sviluppatore, con argomenti JSON. L’applicazione esegue la funzione e rimanda il risultato; il modello non esegue mai codice da solo.

[Backoff esponenziale (exponential backoff)](https://broadrouter.com/it/glossary/exponential-backoff/)

Il backoff esponenziale è una strategia di retry in cui un client aspetta sempre di più dopo ogni tentativo fallito, di solito raddoppiando il ritardo fino a un tetto, prima di riprovare. Aggiungere un jitter casuale a ogni attesa distribuisce i retry di molti client, così non colpiscono il server nello stesso istante.

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

La Chat Completions API è l’endpoint HTTP di OpenAI, POST /v1/chat/completions, che riceve il nome di un modello e una lista di messaggi con un ruolo e restituisce il messaggio successivo del modello. La forma della sua richiesta e risposta è diventata il formato comune che riusano provider e SDK compatibili con OpenAI.

## Domande frequenti

### spring.ai.openai.base-url deve includere /v1?

Sì. In Spring AI 2.x il valore passa invariato al client openai-java, il cui default è https://api.openai.com/v1. Usa https://inference.broadnet.ai/v1.

### Con BroadNet devo usare max-tokens o max-completion-tokens?

max-tokens. La documentazione di Spring AI dice che i due si escludono a vicenda. Il riferimento API di BroadNet descrive il campo max\_tokens, e il ragionamento conta in quel limite, quindi imposta almeno 1.000 token.

### Il tool calling di Spring AI funziona con BroadNet?

Usa GLM 5.3 o Qwen3.8 27B, che BroadNet indica con gli strumenti. La documentazione di BroadNet non indica il tool calling per DeepSeek V4.1 Flash.

### Posso tenere OpenAI per gli embedding e usare BroadNet per la chat?

Sì. spring.ai.openai.chat.base-url e spring.ai.openai.chat.api-key sovrascrivono le proprietà condivise solo per il modello di chat. Il riferimento API di BroadNet non elenca un endpoint per gli embedding.

## Guide correlate

-   [Chiamare BroadNet Inference da Go con l’SDK openai-go](https://broadrouter.com/it/guides/openai-go-sdk/)
-   [Usare l’SDK Python di OpenAI con BroadNet Inference](https://broadrouter.com/it/guides/openai-python-sdk/)
-   [Perché un modello di ragionamento restituisce una risposta vuota](https://broadrouter.com/it/guides/reasoning-tokens-empty-response/)
-   [Codici di errore di BroadNet Inference e quando ritentare](https://broadrouter.com/it/guides/errors-and-retries/)
-   [Tutti gli strumenti che funzionano con BroadNet Inference (in inglese)](https://broadrouter.com/integrations/): SDK, agenti di coding, interfacce di chat e strumenti di automazione, con le impostazioni esatte per ciascuno

Provalo sul tuo carico di lavoro reale. I nuovi account partono con USD 5 di credito per Gemma e trascrizione. DeepSeek, GLM e Qwen3.8 richiedono una ricarica.

[Inizia](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-guides-spring-ai-openai-base-url&utm_content=page-cta) ·

**Fonti**

-   [Riferimento di Spring AI, OpenAI Chat (2.0.2) (verificato il 2026-11-15)](https://docs.spring.io/spring-ai/reference/api/chat/openai-chat.html)
-   [Sorgente di Spring AI alla v2.0.2, OpenAiSetup.calculateBaseUrl (verificato il 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)
-   [Riferimento API di BroadNet Inference (verificato il 2026-11-15) (in inglese)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-guides-spring-ai-openai-base-url&utm_content=sources)
