BroadRouter
Commencer

Première requête à BroadNet Inference avec curl

Mis à jour

Envoyez un POST à https://inference.broadnet.ai/v1/chat/completions avec l’en-tête Authorization Bearer et votre clé, et un corps JSON contenant model, par exemple broadnet/gemma-4-26b-a4b, et messages. Ajoutez stream true pour le streaming. Pour l’audio, envoyez un formulaire multipart avec model, language et file à /v1/audio/transcriptions.

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.

Questions fréquentes

Quel modèle puis-je appeler avec le crédit de départ gratuit ?

BroadNet Gemma 4 VL 26B, ID de modèle broadnet/gemma-4-26b-a4b, ainsi que les deux modèles de transcription. GLM 5.3, Qwen3.8 27B et DeepSeek V4.1 Flash nécessitent une recharge.

Pourquoi le contenu du message est-il vide dans ma réponse curl ?

Les modèles de raisonnement consomment d’abord max_tokens pour raisonner. Si finish_reason vaut length, augmentez max_tokens à 1 000 ou plus.

Pourquoi ma transcription arabe est-elle en lettres latines ?

La requête n’avait pas de champ language. Envoyez language=ar pour l’arabe et le code ISO 639-1 correspondant pour les autres langues.

Est-ce que GET /v1/models liste tous les modèles que je peux appeler ?

La documentation de BroadNet indique que GET /v1/models « supplies public catalogue metadata for external monitors » (traduction : « fournit des métadonnées publiques de catalogue pour les outils de supervision externes »). Pour vos requêtes, utilisez les ID de modèle de la référence de l’API ou de pricing.json.

Lire en MarkdownDemander à ChatGPTDemander à ClaudeDemander à Perplexity