Cette page vous mène d’une nouvelle clé à trois appels fonctionnels : une chat completion, une réponse en streaming et une transcription. Il vous suffit de curl. BroadNet Inference reprend le format de requête d’OpenAI : une fois ces appels en place, n’importe quel SDK compatible OpenAI ou outil compatible fonctionnera aussi.
1. Définir votre clé
Créez une clé dans la console de BroadNet. Les nouveaux comptes reçoivent $5 de crédit de départ.
export BROADNET_API_KEY='paste-your-key'
N’envoyez la clé que dans l’en-tête Authorization: Bearer.
2. Votre première chat completion
BroadNet Gemma 4 VL 26B est le seul modèle de chat utilisable avec le crédit de départ. Commencez donc par lui :
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": "Say hello in English and Arabic."}]
}'
La réponse est un JSON de chat completions standard. Le texte se trouve dans choices[0].message.content, et usage contient le nombre de tokens qui vous est facturé.
3. Essayer un modèle de raisonnement
Après une recharge, changez de modèle. GLM 5.3, Qwen3.8 27B et DeepSeek V4.1 Flash raisonnent avant de répondre, et ce raisonnement est décompté de max_tokens :
curl https://inference.broadnet.ai/v1/chat/completions \
-H "Authorization: Bearer $BROADNET_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "broadnet/glm-5.3",
"max_tokens": 2000,
"reasoning_effort": "low",
"messages": [{"role": "user", "content": "Give me a regex for a UK postcode."}]
}'
Si content est vide et que finish_reason vaut length, le budget s’est épuisé pendant le raisonnement. Voir pourquoi les modèles de raisonnement renvoient des réponses vides.
4. Streamer la réponse
Ajoutez "stream": true et désactivez la mise en mémoire tampon de curl avec -N :
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 to five."}]}'
Vous recevez des Server-Sent Events. Le flux se termine par la ligne littérale data: [DONE], et avec include_usage le dernier chunk contient le nombre de tokens. Plus de détails dans streamer des chat completions.
5. Transcrire de l’audio
La transcription attend un formulaire multipart. Envoyez du WAV ou du MP3, jusqu’à 26 214 400 octets, et envoyez toujours language :
curl https://inference.broadnet.ai/v1/audio/transcriptions \
-H "Authorization: Bearer $BROADNET_API_KEY" \
-F model=broadnet/cohere-transcribe \
-F language=en \
-F file=@meeting.mp3
La réponse est un JSON avec la transcription dans text. Les notes vocales WhatsApp en .ogg et les enregistrements .m4a doivent d’abord être convertis ; voir comment transcrire des notes vocales WhatsApp. Pour l’arabe, utilisez broadnet/cohere-transcribe-arabic avec language=ar ; voir le guide speech-to-text pour l’arabe. Le modèle multilingue coûte $0.002 par minute d’audio et le modèle arabe $0.0042.
Quel modèle choisir ?
| Modèle | ID | Endpoint | Crédit gratuit |
|---|---|---|---|
| BroadNet Gemma 4 VL 26B | broadnet/gemma-4-26b-a4b |
/v1/chat/completions |
Oui |
| GLM 5.3 | broadnet/glm-5.3 |
/v1/chat/completions |
Non |
| Qwen3.8 27B | broadnet/qwen3.8-27b |
/v1/chat/completions |
Non |
| DeepSeek V4.1 Flash | broadnet/deepseek-v4.1-flash |
/v1/chat/completions |
Non |
| BroadNet Transcribe | broadnet/cohere-transcribe |
/v1/audio/transcriptions |
Oui |
| BroadNet Transcribe Arabic | broadnet/cohere-transcribe-arabic |
/v1/audio/transcriptions |
Oui |
Les prix au token et à la minute figurent sur la page des tarifs. Chaque modèle a sa propre page, par exemple GLM 5.3.
Dépannage
- 401. La clé est absente, invalide ou expirée, ou le quota de paiement à l’usage est épuisé. Vérifiez qu’il n’y a pas d’espaces parasites autour de la clé.
- Erreur sur le champ model. Copiez l’ID depuis le tableau ; il inclut le préfixe
broadnet/. Les modèles payants échouent avec le crédit de départ tant que vous n’avez pas rechargé. - 413. Le fichier audio dépasse 26 214 400 octets. Découpez-le.
- 403. La liste d’IP autorisées de la clé, sa politique de modèles ou de routes a refusé la requête. Voir listes d’IP autorisées pour les clés d’API.
- 429. Une clé à l’usage autorise 30 requêtes par minute et 4 requêtes en cours. Patientez avec un backoff, puis réessayez. Voir codes d’erreur et nouvelles tentatives chez BroadNet.
- Avec un forfait illimité. Chaque session de forfait traite une requête à la fois : lancez vos boucles curl parallèles sur des sessions distinctes. Les clés de forfait ne fonctionnent qu’avec
broadnet/deepseek-v4.1-flash.
Conservez l’en-tête de réponse X-Request-ID (curl -D headers.txt ...) quand vous signalez un problème.
