---
title: "Démarrage rapide BroadNet Inference : Python et cURL"
description: "Envoyez votre première requête de chat et de transcription à BroadNet Inference avec Python ou cURL, puis suivez la checklist de migration pour votre modèle."
url: https://broadrouter.com/fr/developers/
lang: fr
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

# Développeurs

Mis à jour 2026-11-15

BroadNet Inference utilise les formats de requête d’OpenAI sur `https://inference.broadnet.ai/v1`. Créez une clé dans la console, stockez-la dans une variable d’environnement et envoyez une requête à `/chat/completions` ou `/audio/transcriptions` avec un ID de modèle exact. Avant de basculer du trafic de production, vérifiez les paramètres, le streaming, les outils, les limites et les erreurs de ce modèle.

-   Démarrage rapide chat
-   Démarrage rapide transcription
-   IDs de modèle
-   Checklist de migration
-   Erreurs et relances
-   Docs et guides

## Comment envoyer ma première requête de chat ?

1.  Connectez-vous sur [inference.broadnet.ai (en anglais)](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-developers&utm_content=quickstart-account) et créez une clé d’inférence. Elle n’est affichée qu’une fois ; la console n’en garde que l’empreinte (hash).
2.  Installez le SDK OpenAI et définissez la clé dans votre terminal. Gardez les clés sur votre serveur, jamais dans du code côté navigateur.
3.  Envoyez la requête. Lisez la réponse dans `choices[0].message.content`.

setup

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

first\_request.py

```
import os
from openai import OpenAI

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

request.sh

```
curl https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"broadnet/gemma-4-26b-a4b","messages":[{"role":"user","content":"Reply with one short sentence."}]}'
```

L’exemple utilise BroadNet Gemma 4 VL 26B, couvert par le crédit de départ de USD 5. DeepSeek V4.1 Flash, GLM 5.3 et Qwen3.8 27B nécessitent d’abord une recharge. Conservez l’en-tête de réponse `X-Request-ID` pour le support.

How a request reaches a model

1.  01**Your app**Key kept in an environment variable
    
2.  02**OpenAI SDK**Two settings change
    
    `base_url` `api_key`
    
3.  03**BroadNet Inference**OpenAI-compatible API`inference.broadnet.ai/v1``POST /chat/completions`
    
4.  04**The model you name**Set in every request
    
    -   `broadnet/deepseek-v4.1-flash`
    -   `broadnet/glm-5.3`
    -   `broadnet/qwen3.8-27b`
    -   `broadnet/gemma-4-26b-a4b`your choice
    
5.  05**Response**From that model
    

You choose the model in each request. There is no automatic routing: the request runs on the model ID you sent.

Your app calls the OpenAI SDK with BroadNet’s base URL and your key. The request goes to BroadNet Inference with the model ID you wrote, and that model answers. Nothing picks or switches the model for you.

### Streaming

Définissez `stream=true` et lisez les Server-Sent Events jusqu’à `data: [DONE]`. Avec `stream_options.include_usage`, l’usage des tokens arrive dans le dernier fragment. Si le flux se termine avant `[DONE]`, considérez la réponse comme incomplète. BroadNet demande de vérifier le streaming pour chaque modèle avant de s’y fier en production.

stream.sh

```
curl -N https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"broadnet/gemma-4-26b-a4b","stream":true,"stream_options":{"include_usage":true},"messages":[{"role":"user","content":"Count from one to three."}]}'
```

## Comment transcrire de l’audio ?

Envoyez du WAV ou du MP3, jusqu’à 26 214 400 octets par fichier, à `/audio/transcriptions`. Définissez toujours `language` : sans ce champ, l’arabe peut revenir en lettres latines. Utilisez `language=ar` pour l’arabe. Convertissez d’abord les fichiers `.ogg` ou `.m4a` : `ffmpeg -i voice-note.ogg -ar 16000 -ac 1 voice-note.wav`

transcribe.py

```
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)
with open("recording.wav", "rb") as audio:
    result = client.audio.transcriptions.create(
        model="broadnet/cohere-transcribe-arabic",
        file=audio,
        language="ar",
    )
print(result.text)
```

transcribe.sh

```
curl https://inference.broadnet.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -F model=broadnet/cohere-transcribe-arabic \
  -F language=ar \
  -F file=@voice-note.wav
```

La réponse est un JSON avec la transcription dans `text`. [Modèle arabe ou multilingue, et coût de l’audio](https://broadrouter.com/fr/arabic-transcription/).

## Quels IDs de modèle puis-je utiliser ?

Passez l’ID exact dans `model`. Ne comptez pas sur `/v1/models` pour découvrir les modèles de chat ; utilisez cette liste ou la [référence (en anglais)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-developers&utm_content=models-docs#models).

| Modèle | ID | Endpoint | Entrée | Documenté | Accès |
| --- | --- | --- | --- | --- | --- |
| [DeepSeek V4.1 Flash](https://broadrouter.com/fr/models/deepseek-v4.1-flash/) | `broadnet/deepseek-v4.1-flash` | `/chat/completions` | Texte + Image | Raisonnement | Recharge requise |
| [GLM 5.3](https://broadrouter.com/fr/models/glm-5.3/) | `broadnet/glm-5.3` | `/chat/completions` | Texte | Outils, Sortie structurée, Raisonnement | Recharge requise |
| [Qwen3.8 27B](https://broadrouter.com/fr/models/qwen3.8-27b/) | `broadnet/qwen3.8-27b` | `/chat/completions` | Texte + Image | Outils, Sortie structurée, Raisonnement | Recharge requise |
| [BroadNet Gemma 4 VL 26B](https://broadrouter.com/fr/models/gemma-4-vl-26b/) | `broadnet/gemma-4-26b-a4b` | `/chat/completions` | Texte + Image | — | Crédit de départ |
| [BroadNet Transcribe Arabic](https://broadrouter.com/fr/models/cohere-transcribe-arabic/) | `broadnet/cohere-transcribe-arabic` | `/audio/transcriptions` | Audio en arabe | — | Crédit de départ |
| [BroadNet Transcribe](https://broadrouter.com/fr/models/cohere-transcribe/) | `broadnet/cohere-transcribe` | `/audio/transcriptions` | Audio, 14 langues | — | Crédit de départ |

« Documenté » indique les outils, la sortie structurée et le raisonnement que la référence de BroadNet cite pour chaque modèle (consultée le 15/11/2026). Un tiret signifie que la référence ne les cite pas, pas qu’ils sont absents.

## Migrer depuis une autre API compatible OpenAI : checklist

Les formats de requête vous seront familiers, mais les modèles diffèrent. Vérifiez chaque point pour le modèle choisi et testez avant de basculer le trafic.

1.  **Endpoint.** Définissez l’URL de base sur `https://inference.broadnet.ai/v1`.
2.  **Clé.** Utilisez une clé d’inférence BroadNet lue depuis une variable d’environnement. Les clés de forfait et les clés à l’usage sont distinctes.
3.  **ID du modèle.** Utilisez l’ID exact, par exemple `broadnet/gemma-4-26b-a4b`.
4.  **Paramètres.** Vérifiez que chaque paramètre envoyé est documenté pour ce modèle. Retirez ceux qui n’y figurent pas.
5.  **Streaming.** Vérifiez que votre client lit le SSE jusqu’à `[DONE]` et gère un flux qui se termine trop tôt.
6.  **Outils et sortie structurée.** La référence les documente pour GLM 5.3 et Qwen3.8 27B. Testez tout autre modèle avant de vous y fier.
7.  **Raisonnement.** Le raisonnement peut consommer une partie du budget de sortie. Laissez de la marge dans `max_tokens` ; voir [réponses vides des modèles de raisonnement](https://broadrouter.com/fr/guides/reasoning-tokens-empty-response/).
8.  **Limites.** Une clé à l’usage autorise 30 requêtes par minute et 4 simultanées. Une session de forfait autorise une requête à la fois. Une clé horaire Gemma autorise un flux, 120 requêtes par minute et 300 000 tokens par minute.
9.  **Contexte.** Le contexte comprend l’entrée et la réponse. Vérifiez la limite du modèle sur sa [page modèle](https://broadrouter.com/fr/models/).
10.  **Erreurs.** Associez chaque code d’état ci-dessous à une relance ou à une correction, et journalisez `X-Request-ID`.
11.  **Coûts.** Faites une estimation avec les [calculateurs de prix](https://broadrouter.com/fr/pricing/). Les images comptent comme des tokens d’entrée en paiement à l’usage.

## Quelles erreurs dois-je relancer ?

| Statut | Signification | Action |
| --- | --- | --- |
| 400 / 422 | Requête ou champ invalide | Corrigez la requête ; ne la relancez pas telle quelle |
| 401 | Clé absente, invalide ou expirée, ou quota épuisé | Vérifiez la clé et le compte |
| 402 | `insufficient_balance` | Rechargez, puis relancez |
| 413 | Requête au-delà de la limite d’octets ou de texte | Envoyez moins, par exemple un fichier audio plus petit |
| 429 | Limite de débit, de concurrence, de tokens par minute ou de dépense | Patientez avec un plafond (backoff), puis relancez |
| 500–504 | Problème côté serveur | Relancez avec un backoff exponentiel borné |

Résumé à partir du [tableau des erreurs de la référence (en anglais)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-developers&utm_content=errors-docs#errors), consulté le 15/11/2026. [Exemples de code de relance](https://broadrouter.com/fr/guides/errors-and-retries/).

## Où trouver la documentation complète et les guides ?

-   [**Référence développeur (en anglais)**Formats de requête, limites, erreurs et flux de prix. La source qui fait foi.](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-developers&utm_content=docs)
-   [**Intégrations (en anglais)**Réglages pour Aider, Cline, LangChain, n8n, LiteLLM et d’autres outils compatibles OpenAI.](https://broadrouter.com/integrations/)
-   [**Guides**SDK, streaming, relances, listes d’IP autorisées et voix arabe.](https://broadrouter.com/fr/guides/)
-   [**Guide du SDK Python**Installation, première requête et streaming avec le SDK OpenAI pour Python.](https://broadrouter.com/fr/guides/openai-python-sdk/)
-   [**Guide du SDK Node**La même chose en JavaScript et TypeScript, avec les IDs de requête.](https://broadrouter.com/fr/guides/openai-node-sdk/)
-   [**Démarrage rapide cURL**Toutes les requêtes depuis le terminal.](https://broadrouter.com/fr/guides/curl-quickstart/)
-   [**Clés et listes d’IP autorisées**Limitez vos clés à vos serveurs.](https://broadrouter.com/fr/guides/api-keys-ip-allow-lists/)
-   [**Générateur de requêtes API (en anglais)**Composez une requête dans votre navigateur et copiez-la.](https://broadrouter.com/tools/api-request-builder/)

Besoin d’un endpoint privé ou d’un modèle qui n’est pas listé ? [Contacter BroadNet](https://broadrouter.com/fr/contact/#private).

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-developers&utm_content=page-cta) ·

**Sources**

-   [Référence développeur de BroadNet Inference (consultée le 15/11/2026) (en anglais)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-developers&utm_content=sources)
-   [Tarifs de BroadNet Inference (en anglais)](https://inference.broadnet.ai/pricing?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-developers&utm_content=sources)
-   [pricing.json, la grille tarifaire publiée (en anglais)](https://inference.broadnet.ai/pricing.json?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-developers&utm_content=sources)
