---
title: "SDK Python OpenAI avec une base_url personnalisée | BroadRouter"
description: "Branchez le SDK Python officiel d’OpenAI sur BroadNet Inference en changeant la base_url : installation, clé, première requête et réponse en streaming."
url: https://broadrouter.com/fr/guides/openai-python-sdk/
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/openai-python-sdk/) (mis à jour le 2026-11-16).

# Utiliser le SDK Python d’OpenAI avec BroadNet Inference

Mis à jour 2026-11-16

Installez le paquet openai, puis créez le client avec base\_url défini sur https://inference.broadnet.ai/v1 et votre clé BroadNet comme api\_key. Tous les appels chat.completions fonctionnent sans modification ; seul l’ID du modèle change, par exemple broadnet/deepseek-v4.1-flash. BroadNet sert les chat completions et les transcriptions, pas la Responses API.

Il vous faut un compte BroadNet Inference et une clé d’inférence. Les nouveaux comptes démarrent avec $5 de crédit, sans carte ; [créez-en un sur inference.broadnet.ai](https://inference.broadnet.ai/?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-guides-openai-python-sdk&utm_content=body). La console n’affiche une clé qu’une seule fois et n’en conserve que le hash : copiez-la directement dans votre environnement.

## 1\. Installer et définir la clé

Le paquet `openai` actuel (3.x) nécessite Python 3.10 ou plus récent.

```bash
python -m pip install openai
export BROADNET_API_KEY='paste-the-key-once'
```

## 2\. Envoyer une première requête

Enregistrez ceci sous `first_request.py` :

```python
from openai import OpenAI
import os

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)

response = client.chat.completions.create(
    model="broadnet/gemma-4-26b-a4b",
    messages=[{"role": "user", "content": "Reply with one short sentence."}],
)
print(response.choices[0].message.content)
```

Lancez-le avec `python first_request.py`. L’exemple utilise `broadnet/gemma-4-26b-a4b` parce qu’il fonctionne avec le crédit gratuit. Les autres modèles de chat sont disponibles après une recharge.

## 3\. Passer au modèle de votre choix

Ne changez que `model` :

| Vous voulez | ID du modèle |
| --- | --- |
| Illimité avec un forfait, contexte de 1M | `broadnet/deepseek-v4.1-flash` |
| Outils et sortie structurée, contexte de 1M | `broadnet/glm-5.3` |
| Texte et images en arabe | `broadnet/qwen3.8-27b` |
| Prix bas, fonctionne avec le crédit gratuit | `broadnet/gemma-4-26b-a4b` |

DeepSeek V4.1 Flash, GLM 5.3 et Qwen3.8 27B raisonnent avant de répondre, et ce raisonnement est décompté de `max_tokens`. Accordez-leur 1 000 tokens ou plus. [Voici pourquoi une limite trop basse renvoie une réponse vide](https://broadrouter.com/fr/guides/reasoning-tokens-empty-response/).

## 4\. Streamer la réponse

```python
stream = client.chat.completions.create(
    model="broadnet/deepseek-v4.1-flash",
    stream=True,
    stream_options={"include_usage": True},
    messages=[{"role": "user", "content": "Count from one to three."}],
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
    if chunk.usage:
        print("\n", chunk.usage)
```

Avec `include_usage`, le nombre de tokens arrive dans le dernier chunk, qui n’a pas de `choices`. [Le guide du streaming](https://broadrouter.com/fr/guides/streaming-chat-completions/) traite des connexions interrompues.

## 5\. Conserver l’ID de requête

Chaque réponse porte un en-tête `X-Request-ID`. Journalisez-le : le support de BroadNet vous le demandera. Les réponses analysées l’exposent sous `response._request_id`. Pour le lire avec les autres en-têtes :

```python
raw = client.chat.completions.with_raw_response.create(
    model="broadnet/gemma-4-26b-a4b",
    messages=[{"role": "user", "content": "Hi"}],
)
print(raw.headers.get("x-request-id"))
response = raw.parse()
```

Les clés à l’usage autorisent 30 requêtes par minute et 4 requêtes en cours. [Ce que signifie chaque code d’erreur et quand réessayer](https://broadrouter.com/fr/guides/errors-and-retries/).

## Dépannage

-   **`AuthenticationError` (401).** La clé est erronée, expirée ou son quota de paiement à l’usage est épuisé. Vérifiez que `BROADNET_API_KEY` est bien définie dans le processus qui exécute votre code.
-   **`NotFoundError` (404).** Vérifiez que `base_url` se termine par `/v1` et que vous appelez `chat.completions`, pas `responses`. Vérifiez ensuite l’ID du modèle, avec le préfixe `broadnet/`.
-   **Un modèle payant échoue sur un nouveau compte.** Le crédit de départ de $5 couvre BroadNet Gemma 4 VL 26B (`broadnet/gemma-4-26b-a4b`) et les deux modèles BroadNet Transcribe. Rechargez pour utiliser les autres modèles de chat : DeepSeek V4.1 Flash, GLM 5.3 et Qwen3.8 27B.
-   **`content` vide.** Le raisonnement est décompté de `max_tokens`. Montez-le à 1 000 ou plus. [Pourquoi les réponses reviennent vides](https://broadrouter.com/fr/guides/reasoning-tokens-empty-response/).
-   **`RateLimitError` (429).** Vous avez dépassé la limite par minute ou de requêtes simultanées. Par défaut, le SDK réessaie deux fois ; réglez `max_retries` sur le client pour changer ce comportement.
-   **Erreurs de client HTTP personnalisé après une mise à jour.** Le SDK 3.x utilise HTTPX2. Si vous passez votre propre `http_client`, suivez le guide de migration HTTPX2 du SDK.

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

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

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

[Streaming](https://broadrouter.com/fr/glossary/streaming/)

Le streaming est une manière de renvoyer la réponse d’un modèle de langage par petits chunks pendant sa génération, plutôt qu’en un seul bloc à la fin. Les API compatibles OpenAI streament via des server-sent events quand la requête règle stream sur true.

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

[Clé d’API (API key)](https://broadrouter.com/fr/glossary/api-key/)

Une clé d’API est une chaîne secrète qui identifie et autorise un client qui appelle une API. Les API LLM l’attendent généralement dans un en-tête Authorization: Bearer, et quiconque détient la clé peut envoyer des requêtes facturées au compte qui la possède.

[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

### Ai-je besoin d’un autre SDK ?

Non. BroadNet Inference parle les formats chat completions et audio transcriptions d’OpenAI : le paquet officiel openai fonctionne avec une autre base\_url.

### Puis-je continuer à utiliser OPENAI\_API\_KEY ?

Oui, mais une variable BROADNET\_API\_KEY distincte évite d’envoyer par erreur la clé d’un fournisseur à un autre.

### Le SDK lit-il OPENAI\_BASE\_URL ?

Oui. Si vous ne passez pas base\_url, le client utilise OPENAI\_BASE\_URL. Définissez-la sur https://inference.broadnet.ai/v1 et OPENAI\_API\_KEY sur votre clé BroadNet : OpenAI() n’a alors besoin d’aucun argument.

### Puis-je utiliser client.responses.create avec BroadNet ?

Non. Le README du SDK met en avant la Responses API, mais la documentation de BroadNet ne mentionne que les chat completions et les audio transcriptions. Utilisez client.chat.completions.create.

## Guides associés

-   [Utiliser le SDK Node.js d’OpenAI avec BroadNet Inference](https://broadrouter.com/fr/guides/openai-node-sdk/)
-   [Streamer des chat completions et gérer les connexions coupées](https://broadrouter.com/fr/guides/streaming-chat-completions/)
-   [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/)

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-openai-python-sdk&utm_content=page-cta) ·

**Sources**

-   [Référence de l’API de BroadNet Inference, première requête (en anglais)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-guides-openai-python-sdk&utm_content=sources#base-url)
-   [Bibliothèque Python d’OpenAI sur PyPI (3.x, Python 3.10+, consulté le 2026-11-14)](https://pypi.org/project/openai/)
