---
title: "CrewAI : base_url personnalisée compatible OpenAI | BroadRouter"
description: "Branchez vos agents CrewAI sur BroadNet Inference avec LLM(custom_openai=True, base_url=...), puis choisissez les modèles pour outils, long contexte et forfait."
url: https://broadrouter.com/fr/guides/crewai-custom-openai-endpoint/
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/crewai-custom-openai-endpoint/) (mis à jour le 2026-11-16).

# CrewAI avec BroadNet Inference comme endpoint OpenAI personnalisé

Mis à jour 2026-11-16

Créez le modèle avec la classe LLM de crewai en passant model défini sur un ID BroadNet comme broadnet/glm-5.3, custom\_openai=True, base\_url sur https://inference.broadnet.ai/v1 et api\_key sur votre clé BroadNet. Donnez ensuite ce LLM à chaque Agent. CrewAI utilise son client OpenAI natif et les chat completions : inutile d’installer LiteLLM.

CrewAI est un framework Python pour des équipes d’agents. Sa documentation présente un schéma d’**endpoint personnalisé compatible OpenAI** : un `LLM` avec `custom_openai=True` et une `base_url`. BroadNet Inference sert des chat completions standard à l’adresse `https://inference.broadnet.ai/v1` et s’y branche donc directement. BroadRouter est le site de BroadNet ; ce guide suit la documentation et le code source de CrewAI dans sa version 1.15.41.

## Installation

```bash
pip install crewai
export BROADNET_API_KEY='your-broadnet-key'
```

## Connexion

```python
import os
from crewai import LLM, Agent

llm = LLM(
    model="broadnet/glm-5.3",
    custom_openai=True,
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
    max_tokens=4000,  # reasoning counts toward this limit
)

# Quick test: one call straight to the model
print(llm.call("Say hello in five words."))

analyst = Agent(
    role="Analyst",
    goal="Summarize incidents",
    backstory="You write short incident summaries.",
    llm=llm,
)
print(analyst.kickoff("Summarize: the API returned 503 for four minutes after a deploy."))
```

Si `llm.call` affiche une réponse, la clé, l’URL et l’ID du modèle sont corrects.

## Comment CrewAI achemine la requête

Le code source de CrewAI fixe un ordre : `custom_openai=True` passe en premier et impose le fournisseur OpenAI natif, quel que soit ce que suggère le nom du modèle. CrewAI lève aussi une erreur si aucun endpoint personnalisé n’est défini via `base_url`, `api_base`, `OPENAI_BASE_URL` ou `OPENAI_API_BASE`. La chaîne du modèle est envoyée telle quelle : `broadnet/glm-5.3` arrive inchangé chez BroadNet.

Sans `custom_openai`, un nom comme `broadnet/glm-5.3` serait lu comme le fournisseur `broadnet`, que CrewAI ne connaît pas, et basculerait vers LiteLLM. L’alternative documentée est `model="openai/broadnet/glm-5.3"` avec une `base_url` : CrewAI retire le préfixe `openai/` et envoie le reste.

Deux autres points tirés du code et de la documentation de CrewAI :

-   **Champ de limite de tokens.** Si vous passez `max_tokens`, le client natif envoie `max_tokens` sur les chat completions, le champ que décrit la référence de l’API de BroadNet. Si vous passez `max_completion_tokens`, c’est celui-ci qui est envoyé.
-   **Restez sur les chat completions.** La documentation de CrewAI montre `api="responses"` pour basculer vers la Responses API. Ne l’utilisez pas ; BroadNet ne liste pas cette API.

## Quel modèle pour quel agent ?

| Agent | Modèle | Pourquoi |
| --- | --- | --- |
| Agents avec outils | `broadnet/glm-5.3` | BroadNet indique outils et sortie structurée ; contexte de 1M |
| Entrée image ou arabe, avec outils | `broadnet/qwen3.8-27b` | Outils et images ; contexte de 262K |
| Longues tâches de lecture, forfait | `broadnet/deepseek-v4.1-flash` | Forfaits illimités ; outils non listés par BroadNet |

Une crew peut les combiner : donnez à chaque `Agent` son propre `LLM`.

## Dépannage

-   **401.** La clé est erronée, expirée ou à court de quota. Si vous avez omis `api_key`, CrewAI a lu `OPENAI_API_KEY`, qui contient peut-être une clé OpenAI.
-   **« custom\_openai=True requires base\_url ».** Passez `base_url`, ou définissez `OPENAI_BASE_URL`.
-   **Modèle introuvable.** Vérifiez que l’ID correspond exactement à celui de BroadNet. 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.
-   **`EmptyLLMResponseError`.** CrewAI relance une fois après une réponse vide, puis lève cette erreur. Augmentez `max_tokens`. [Pourquoi les réponses reviennent vides](https://broadrouter.com/fr/guides/reasoning-tokens-empty-response/).
-   **429 avec plusieurs agents.** Une clé à l’usage autorise 30 requêtes par minute et 4 requêtes en cours, et une session de forfait traite une seule requête à la fois. Voir [codes d’erreur et nouvelles tentatives](https://broadrouter.com/fr/guides/errors-and-retries/).

## Termes de ce guide

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

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

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

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

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

[API compatible OpenAI](https://broadrouter.com/fr/glossary/openai-compatible-api/)

Une API compatible OpenAI est une API HTTP qui accepte les mêmes formats de requête et de réponse que l’API OpenAI, comme POST /v1/chat/completions. Les SDK et outils OpenAI peuvent donc l’utiliser en changeant seulement l’URL de base, la clé d’API et le nom du modèle.

[Crédit prépayé (prepaid credit)](https://broadrouter.com/fr/glossary/prepaid-credit/)

Le crédit prépayé est de l’argent versé sur un compte API avant utilisation. Chaque requête déduit son coût du solde, et quand le solde est épuisé, les requêtes facturées s’arrêtent jusqu’à la prochaine recharge. Les dépenses sont ainsi plafonnées à ce que vous avez versé.

## Questions fréquentes

### Que fait custom\_openai=True dans CrewAI ?

D’après le code source de CrewAI, il impose le fournisseur OpenAI natif quel que soit l’aspect du nom du modèle, et il exige base\_url, api\_base, OPENAI\_BASE\_URL ou OPENAI\_API\_BASE. La chaîne du modèle est envoyée telle quelle : broadnet/glm-5.3 arrive inchangé chez BroadNet.

### Puis-je écrire model="openai/broadnet/glm-5.3" à la place ?

Oui. Avec une base\_url personnalisée, CrewAI dirige un préfixe openai/ vers son client OpenAI natif et retire le préfixe : BroadNet reçoit donc broadnet/glm-5.3. custom\_openai=True reste la forme la plus claire.

### Pourquoi ma crew échoue-t-elle avec EmptyLLMResponseError ?

CrewAI relance une fois une réponse vide, sans contenu ni appel d’outil, et lève cette erreur si la nouvelle tentative est vide elle aussi. Avec les modèles à raisonnement de BroadNet, cela signifie généralement que le raisonnement a épuisé le budget de sortie. Augmentez max\_tokens.

### Quel modèle BroadNet utiliser pour les agents CrewAI ?

GLM 5.3 pour les agents avec outils, puisque BroadNet indique pour lui les outils et la sortie structurée. Qwen3.8 27B gère aussi les outils et accepte les images.

## Guides associés

-   [Pydantic AI avec BroadNet Inference (OpenAICompatibleProvider)](https://broadrouter.com/fr/guides/pydantic-ai-openai-compatible/)
-   [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-crewai-custom-openai-endpoint&utm_content=page-cta) ·

**Sources**

-   [Documentation CrewAI, LLMs (OpenAI, endpoint personnalisé compatible OpenAI) (consulté le 2026-11-15)](https://docs.crewai.com/en/concepts/llms)
-   [Code source de CrewAI, routage LLM pour custom\_openai (llm.py) (consulté le 2026-11-15)](https://github.com/crewAIInc/crewAI/blob/main/lib/crewai/src/crewai/llm.py)
-   [PyPI, crewai 1.15.41, Python 3.10 à 3.13 (consulté le 2026-11-15)](https://pypi.org/project/crewai/)
-   [Référence de l’API de BroadNet Inference (consulté le 2026-11-15) (en anglais)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-guides-crewai-custom-openai-endpoint&utm_content=sources)
