Développeurs
Mis à jour
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.
Comment envoyer ma première requête de chat ?

- Connectez-vous sur inference.broadnet.ai (en anglais) 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).
- 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.
- Envoyez la requête. Lisez la réponse dans
choices[0].message.content.
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.
- 01Your appKey kept in an environment variable
- 02OpenAI SDKTwo settings change
base_urlapi_key - 03BroadNet InferenceOpenAI-compatible API
inference.broadnet.ai/v1POST /chat/completions - 04The model you nameSet in every request
broadnet/deepseek-v4.1-flashbroadnet/glm-5.3broadnet/qwen3.8-27bbroadnet/gemma-4-26b-a4byour choice
- 05ResponseFrom 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.
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.wavLa réponse est un JSON avec la transcription dans text. Modèle arabe ou multilingue, et coût de l’audio.
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).
| Modèle | ID | Endpoint | Entrée | Documenté | Accès |
|---|---|---|---|---|---|
| DeepSeek V4.1 Flash | broadnet/deepseek-v4.1-flash | /chat/completions | Texte + Image | Raisonnement | Recharge requise |
| GLM 5.3 | broadnet/glm-5.3 | /chat/completions | Texte | Outils, Sortie structurée, Raisonnement | Recharge requise |
| Qwen3.8 27B | broadnet/qwen3.8-27b | /chat/completions | Texte + Image | Outils, Sortie structurée, Raisonnement | Recharge requise |
| BroadNet Gemma 4 VL 26B | broadnet/gemma-4-26b-a4b | /chat/completions | Texte + Image | — | Crédit de départ |
| BroadNet Transcribe Arabic | broadnet/cohere-transcribe-arabic | /audio/transcriptions | Audio en arabe | — | Crédit de départ |
| BroadNet 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.
- Endpoint. Définissez l’URL de base sur
https://inference.broadnet.ai/v1. - 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.
- ID du modèle. Utilisez l’ID exact, par exemple
broadnet/gemma-4-26b-a4b. - Paramètres. Vérifiez que chaque paramètre envoyé est documenté pour ce modèle. Retirez ceux qui n’y figurent pas.
- Streaming. Vérifiez que votre client lit le SSE jusqu’à
[DONE]et gère un flux qui se termine trop tôt. - 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.
- 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. - 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.
- Contexte. Le contexte comprend l’entrée et la réponse. Vérifiez la limite du modèle sur sa page modèle.
- Erreurs. Associez chaque code d’état ci-dessous à une relance ou à une correction, et journalisez
X-Request-ID. - Coûts. Faites une estimation avec les calculateurs de prix. 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), consulté le 15/11/2026. Exemples de code de relance.
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.
- Intégrations (en anglais)Réglages pour Aider, Cline, LangChain, n8n, LiteLLM et d’autres outils compatibles OpenAI.
- GuidesSDK, streaming, relances, listes d’IP autorisées et voix arabe.
- Guide du SDK PythonInstallation, première requête et streaming avec le SDK OpenAI pour Python.
- Guide du SDK NodeLa même chose en JavaScript et TypeScript, avec les IDs de requête.
- Démarrage rapide cURLToutes les requêtes depuis le terminal.
- Clés et listes d’IP autoriséesLimitez vos clés à vos serveurs.
- Générateur de requêtes API (en anglais)Composez une requête dans votre navigateur et copiez-la.
Besoin d’un endpoint privé ou d’un modèle qui n’est pas listé ? Contacter BroadNet.
Lire en MarkdownDemander à ChatGPTDemander à ClaudeDemander à Perplexity