---
title: "API LLM avec curl : chat, streaming et transcription"
description: "Premiers appels à BroadNet Inference avec curl : chat completion, réponse en streaming, transcription audio, puis lecture de la réponse, de l’usage et des erreurs."
url: https://broadrouter.com/fr/guides/curl-quickstart/
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/curl-quickstart/) (mis à jour le 2026-11-16).

# Première requête à BroadNet Inference avec curl

Mis à jour 2026-11-16

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](https://broadrouter.com/fr/guides/openai-python-sdk/) 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.

```bash
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 :

```bash
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` :

```bash
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](https://broadrouter.com/fr/guides/reasoning-tokens-empty-response/).

## 4\. Streamer la réponse

Ajoutez `"stream": true` et désactivez la mise en mémoire tampon de curl avec `-N` :

```bash
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](https://broadrouter.com/fr/guides/streaming-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` :

```bash
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](https://broadrouter.com/fr/guides/transcribe-whatsapp-voice-notes/). Pour l’arabe, utilisez `broadnet/cohere-transcribe-arabic` avec `language=ar` ; voir le [guide speech-to-text pour l’arabe](https://broadrouter.com/fr/guides/arabic-speech-to-text-api/). 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](https://broadrouter.com/fr/pricing/). Chaque modèle a sa propre page, par exemple [GLM 5.3](https://broadrouter.com/fr/models/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](https://broadrouter.com/fr/guides/api-keys-ip-allow-lists/).
-   **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](https://broadrouter.com/fr/guides/errors-and-retries/).
-   **Avec un forfait illimité.** Chaque [session de forfait](https://broadrouter.com/fr/guides/unlimited-llm-api-sessions/) 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.

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

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

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

[Liste d’IP autorisées (IP allow list)](https://broadrouter.com/fr/glossary/ip-allow-list/)

Une liste d’IP autorisées est un contrôle de sécurité qui n’accepte que les requêtes provenant d’adresses IP ou de plages CIDR listées et refuse toutes les autres. Sur une API, elle limite les dégâts d’une clé divulguée, car la clé ne fonctionne pas depuis des réseaux absents de la liste.

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

[API Chat Completions](https://broadrouter.com/fr/glossary/chat-completions-api/)

L’API Chat Completions est l’endpoint HTTP d’OpenAI, POST /v1/chat/completions, qui reçoit un nom de modèle et une liste de messages associés à un rôle, et renvoie le message suivant du modèle. Sa forme de requête et de réponse est devenue le format commun que reprennent les fournisseurs et SDK compatibles OpenAI.

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

[API compatible OpenAI](https://broadrouter.com/fr/glossary/openai-compatible-api/)

Une API compatible OpenAI est une API HTTP qui accepte les mêmes formats de requête et de réponse que l’API OpenAI, comme POST /v1/chat/completions. Les SDK et outils OpenAI peuvent donc l’utiliser en changeant seulement l’URL de base, la clé d’API et le nom du modèle.

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

## Guides associés

-   [Utiliser le SDK Python d’OpenAI avec BroadNet Inference](https://broadrouter.com/fr/guides/openai-python-sdk/)
-   [Streamer des chat completions et gérer les connexions coupées](https://broadrouter.com/fr/guides/streaming-chat-completions/)
-   [API speech-to-text pour l’arabe, étape par étape](https://broadrouter.com/fr/guides/arabic-speech-to-text-api/)
-   [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-curl-quickstart&utm_content=page-cta) ·

**Sources**

-   [Référence de l’API de BroadNet Inference (en anglais)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-guides-curl-quickstart&utm_content=sources)
-   [Liste des modèles et prix lisibles par machine (pricing.json) (en anglais)](https://inference.broadnet.ai/pricing.json?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-guides-curl-quickstart&utm_content=sources)
