---
title: "Spring AI : starter OpenAI avec une base-url personnalisée"
description: "Pointez le starter de chat OpenAI de Spring AI vers BroadNet Inference avec spring.ai.openai.base-url, un ID BroadNet et max-tokens, puis appelez ChatClient."
url: https://broadrouter.com/fr/guides/spring-ai-openai-base-url/
lang: fr
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traduit de l’anglais avec l’aide de l’IA. [Lire l’original en anglais](https://broadrouter.com/guides/spring-ai-openai-base-url/) (mis à jour le 2026-11-16).

# Utiliser Spring AI avec BroadNet Inference (base-url OpenAI)

Mis à jour 2026-11-16

Ajoutez spring-ai-starter-model-openai, puis réglez spring.ai.openai.base-url sur https://inference.broadnet.ai/v1, spring.ai.openai.api-key sur votre clé BroadNet et spring.ai.openai.chat.model sur un ID BroadNet comme broadnet/glm-5.3. Réglez spring.ai.openai.chat.max-tokens en laissant de la place au raisonnement. Spring AI 2.x utilise le SDK openai-java, qui ajoute /chat/completions à la base URL.

Spring AI est le framework du projet Spring pour l’IA en Java. Son starter de chat OpenAI lit une `base-url` : il peut donc appeler n’importe quel serveur compatible OpenAI. BroadNet Inference sert des chat completions standard à l’adresse `https://inference.broadnet.ai/v1`. BroadRouter est le site de BroadNet ; ce guide suit la référence de Spring AI 2.0.2.

## Ajouter le starter

Avec le BOM Spring AI en place (voir la documentation de Spring AI sur la gestion des dépendances) :

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

## Configurer

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

Gardez `/v1` dans l’URL. Dans Spring AI 2.x, la valeur part telle quelle vers le client openai-java (`OpenAiSetup.calculateBaseUrl` la renvoie sans modification), et ce client ajoute `/chat/completions`. La valeur par défaut qu’elle remplace est `https://api.openai.com/v1`.

## Appeler et tester

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

Lancez l’application. Si une réponse s’affiche, la clé, l’URL et l’ID du modèle sont corrects.

## Les réglages qui comptent pour BroadNet

-   **`max-tokens`, pas `max-completion-tokens`.** La documentation de Spring AI indique qu’ils s’excluent mutuellement et que définir les deux est une erreur. La référence de l’API de BroadNet décrit `max_tokens`. DeepSeek V4.1 Flash, GLM 5.3 et Qwen3.8 27B raisonnent d’abord, et le raisonnement compte dans la limite.
-   **Texte du raisonnement.** Spring AI peut exposer `reasoning_content` pour les serveurs compatibles OpenAI qui le renvoient. La référence de l’API de BroadNet indique le nombre de tokens de raisonnement dans `usage`, mais ne garantit pas le texte du raisonnement lui-même : n’en dépendez pas.
-   **Surcharge propre au chat.** `spring.ai.openai.chat.base-url` et `spring.ai.openai.chat.api-key` priment sur les propriétés communes pour le modèle de chat. Utilisez-les si d’autres modèles OpenAI de Spring AI (comme les embeddings) doivent rester chez OpenAI.
-   **Nouvelles tentatives.** `spring.ai.retry.max-attempts` vaut 10 par défaut, avec un backoff exponentiel. Avec une clé à l’usage, cela peut épuiser la limite par minute ; pensez à la réduire.

## Quel modèle choisir ?

| Usage | `spring.ai.openai.chat.model` |
| --- | --- |
| Appel d’outils, sortie structurée | `broadnet/glm-5.3` |
| Images ou texte arabe | `broadnet/qwen3.8-27b` |
| Longs documents, forfait à prix fixe | `broadnet/deepseek-v4.1-flash` |
| Crédit de départ gratuit | `broadnet/gemma-4-26b-a4b` |

[Les prix de chaque modèle](https://broadrouter.com/fr/pricing/).

## Dépannage

-   **401.** La clé est erronée, a expiré ou a épuisé son allocation, ou `BROADNET_API_KEY` n’est pas défini pour la JVM.
-   **404.** Il manque `/v1` dans la base URL, ou l’ID du modèle est erroné. Les modèles payants nécessitent une recharge ; le crédit de $5 ne couvre que `broadnet/gemma-4-26b-a4b` et les deux modèles Transcribe.
-   **`content()` vide.** Le raisonnement a consommé le budget de sortie. Augmentez `max-tokens`. [Pourquoi les réponses reviennent vides](https://broadrouter.com/fr/guides/reasoning-tokens-empty-response/).
-   **400 avec les deux limites de tokens définies.** Supprimez `max-completion-tokens`.
-   **429.** Une clé à l’usage autorise 30 requêtes par minute et 4 requêtes en cours. Voir [codes d’erreur et nouvelles tentatives](https://broadrouter.com/fr/guides/errors-and-retries/).

## Termes de ce guide

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

Un token est l’unité de texte qu’un modèle de langage lit et écrit : un mot, une partie de mot, un signe de ponctuation ou une suite d’octets produite par le tokenizer du modèle. Les API LLM comptent, limitent et facturent généralement l’usage en tokens.

[Concurrence (requêtes simultanées)](https://broadrouter.com/fr/glossary/concurrency/)

La concurrence est le nombre de requêtes qu’un client a en cours au même moment. Les API de LLM la plafonnent souvent par clé ou par forfait, indépendamment des requêtes par minute, car chaque requête ouverte occupe de la capacité GPU jusqu’à la fin de sa réponse.

[Embeddings (plongements vectoriels)](https://broadrouter.com/fr/glossary/embeddings/)

Les embeddings sont des listes de nombres à virgule flottante (des vecteurs) qu’un modèle produit pour représenter un texte, une image ou une autre entrée. Des entrées de sens proche obtiennent des vecteurs voisins : la distance entre vecteurs permet de classer des résultats de recherche, de regrouper des documents ou de trouver des éléments apparentés.

[Appel d’outils (tool calling, function calling)](https://broadrouter.com/fr/glossary/tool-calling/)

L’appel d’outils, aussi appelé function calling, est une fonctionnalité des API LLM dans laquelle le modèle renvoie une demande structurée d’exécution d’une fonction définie par le développeur, avec des arguments JSON. L’application exécute la fonction et renvoie le résultat ; le modèle n’exécute jamais de code lui-même.

[Limite de débit (rate limit)](https://broadrouter.com/fr/glossary/rate-limit/)

Une limite de débit (rate limit) est un plafond qu’une API impose à l’usage d’un client sur une période, par exemple en requêtes ou en tokens par minute. Les requêtes au-delà sont refusées, généralement avec HTTP 429 Too Many Requests, jusqu’à ce que l’usage repasse sous la limite.

[Paiement à l’usage (pay-as-you-go)](https://broadrouter.com/fr/glossary/pay-as-you-go/)

Le paiement à l’usage (pay-as-you-go) est un modèle tarifaire où vous ne payez que ce que vous consommez, mesuré par unité, comme les tokens, les requêtes ou les minutes d’audio, sans abonnement ni engagement minimal. La plupart des API LLM facturent ainsi, à partir d’un solde prépayé ou d’une facture périodique.

[URL de base (base URL)](https://broadrouter.com/fr/glossary/base-url/)

L’URL de base est l’adresse racine fixe d’une API, comme https://api.example.com/v1, que le client place devant chaque chemin d’endpoint, comme /chat/completions. Dans les SDK compatibles OpenAI, changer l’URL de base, avec la clé d’API et l’ID du modèle, oriente le même code vers un autre fournisseur.

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

L’API Chat Completions est l’endpoint HTTP d’OpenAI, POST /v1/chat/completions, qui reçoit un nom de modèle et une liste de messages associés à un rôle, et renvoie le message suivant du modèle. Sa forme de requête et de réponse est devenue le format commun que reprennent les fournisseurs et SDK compatibles OpenAI.

## Questions fréquentes

### spring.ai.openai.base-url doit-il inclure /v1 ?

Oui. Dans Spring AI 2.x, la valeur est transmise telle quelle au client openai-java, dont la valeur par défaut est https://api.openai.com/v1. Utilisez https://inference.broadnet.ai/v1.

### Faut-il utiliser max-tokens ou max-completion-tokens avec BroadNet ?

max-tokens. La documentation de Spring AI indique que les deux s’excluent mutuellement. La référence de l’API de BroadNet décrit le champ max\_tokens, et le raisonnement y est décompté : prévoyez 1 000 tokens ou plus.

### L’appel d’outils de Spring AI fonctionne-t-il avec BroadNet ?

Utilisez GLM 5.3 ou Qwen3.8 27B, que BroadNet indique avec outils. La documentation de BroadNet n’indique pas l’appel d’outils pour DeepSeek V4.1 Flash.

### Puis-je garder OpenAI pour les embeddings et utiliser BroadNet pour le chat ?

Oui. spring.ai.openai.chat.base-url et spring.ai.openai.chat.api-key remplacent les propriétés communes pour le seul modèle de chat. La référence de l’API de BroadNet ne liste pas d’endpoint d’embeddings.

## Guides associés

-   [Appeler BroadNet Inference depuis Go avec le SDK openai-go](https://broadrouter.com/fr/guides/openai-go-sdk/)
-   [Utiliser le SDK Python d’OpenAI avec BroadNet Inference](https://broadrouter.com/fr/guides/openai-python-sdk/)
-   [Pourquoi un modèle de raisonnement renvoie une réponse vide](https://broadrouter.com/fr/guides/reasoning-tokens-empty-response/)
-   [Codes d’erreur de BroadNet Inference : quand réessayer ?](https://broadrouter.com/fr/guides/errors-and-retries/)
-   [Tous les outils compatibles avec BroadNet Inference (en anglais)](https://broadrouter.com/integrations/) : SDK, agents de code, interfaces de chat et outils d’automatisation, avec les réglages exacts pour chacun

Essayez-le sur votre vraie charge de travail. Les nouveaux comptes démarrent avec USD 5 de crédit pour Gemma et transcription. DeepSeek, GLM et Qwen3.8 nécessitent une recharge.

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

**Sources**

-   [Référence Spring AI, OpenAI Chat (2.0.2) (consultée le 2026-11-15)](https://docs.spring.io/spring-ai/reference/api/chat/openai-chat.html)
-   [Code source de Spring AI en v2.0.2, OpenAiSetup.calculateBaseUrl (consulté le 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)
-   [Référence de l’API de BroadNet Inference (consultée le 2026-11-15) (en anglais)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-guides-spring-ai-openai-base-url&utm_content=sources)
