---
title: "Vercel AI SDK : createOpenAICompatible et URL de base"
description: "Appelez BroadNet Inference depuis le Vercel AI SDK avec createOpenAICompatible (@ai-sdk/openai-compatible) : generateText, streamText, outils, raisonnement."
url: https://broadrouter.com/fr/guides/vercel-ai-sdk-openai-compatible/
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/vercel-ai-sdk-openai-compatible/) (mis à jour le 2026-11-16).

# Utiliser le Vercel AI SDK avec BroadNet Inference

Mis à jour 2026-11-16

Installez ai et @ai-sdk/openai-compatible, puis appelez createOpenAICompatible avec name broadnet, baseURL https://inference.broadnet.ai/v1 et votre clé BroadNet comme apiKey. Passez au provider un ID de modèle BroadNet comme broadnet/glm-5.3 et utilisez generateText ou streamText comme d’habitude. Gardez la clé côté serveur et donnez aux modèles de raisonnement un maxOutputTokens généreux.

L’[AI SDK](https://ai-sdk.dev/providers/openai-compatible-providers) de Vercel est une boîte à outils TypeScript pour les applications LLM. Son paquet `@ai-sdk/openai-compatible` crée un provider pour toute API qui suit le format chat completions d’OpenAI. C’est le cas de BroadNet Inference : vous ne changez que l’URL de base, la clé et les ID de modèles. Pour le client OpenAI classique, consultez plutôt [le guide du SDK Node](https://broadrouter.com/fr/guides/openai-node-sdk/).

## Configuration

1.  **Installez les paquets.** Au moment de la rédaction, npm distribue `ai` 7.x et `@ai-sdk/openai-compatible` 3.x.
    
    ```bash
    npm install ai @ai-sdk/openai-compatible
    export BROADNET_API_KEY='your-broadnet-key'
    ```
    
2.  **Créez le provider.**
    
    ```ts
    // broadnet.ts
    import { createOpenAICompatible } from '@ai-sdk/openai-compatible';
    
    export const broadnet = createOpenAICompatible({
      name: 'broadnet',
      baseURL: 'https://inference.broadnet.ai/v1',
      apiKey: process.env.BROADNET_API_KEY,
      includeUsage: true, // usage data in streaming responses
    });
    ```
    
3.  **Générez du texte.**
    
    ```ts
    import { generateText } from 'ai';
    import { broadnet } from './broadnet';
    
    const { text, usage, finishReason } = await generateText({
      model: broadnet('broadnet/glm-5.3'),
      prompt: 'Explain idempotency keys in two sentences.',
      maxOutputTokens: 4000, // reasoning counts toward this
    });
    
    console.log(text, finishReason, usage);
    ```
    
4.  **Streamez.** Remplacez `generateText` par `streamText` et lisez `textStream`. Le [guide du streaming](https://broadrouter.com/fr/guides/streaming-chat-completions/) explique le format de transmission sous-jacent.
    

Le `name` que vous passez devient la clé des options et des métadonnées du provider : gardez-le court et stable. `provider('id')` et `provider.chatModel('id')` créent tous deux un modèle de chat ; il n’y a pas de configuration distincte par modèle. Gardez la clé côté serveur. N’importez pas ce fichier dans du code exécuté dans le navigateur, sinon la clé est envoyée à chaque visiteur.

La documentation du provider liste la génération de texte, le streaming, l’appel d’outils, les sorties structurées, le contenu de raisonnement et les images en entrée parmi les capacités prises en charge, en précisant que certaines dépendent du fournisseur. Chez BroadNet, les images en entrée fonctionnent avec DeepSeek V4.1 Flash, Qwen3.8 27B et Gemma 4 VL 26B. GLM 5.3 n’accepte que du texte.

## Options à régler

-   **reasoningEffort.** Passez-la via `providerOptions`, sous la clé du nom du provider. D’après la documentation de l’AI SDK, les valeurs exactes dépendent du fournisseur ; la documentation de BroadNet montre `low`.

```ts
const result = await generateText({
  model: broadnet('broadnet/deepseek-v4.1-flash'),
  prompt: 'Classify: "refund my order" -> intent?',
  providerOptions: { broadnet: { reasoningEffort: 'low' } },
});
```

-   **supportsStructuredOutputs.** L’AI SDK n’envoie de schémas JSON que si cette option vaut `true` sur le provider. BroadNet indique la sortie structurée pour GLM 5.3 et Qwen3.8 27B. Si vous l’activez, utilisez ces modèles pour les sorties à schéma.
-   **maxRetries.** `generateText` réessaie deux fois par défaut. Ajustez la valeur à votre limite de débit.
-   **Sortie de raisonnement.** L’AI SDK lit le contenu de raisonnement quand le fournisseur le renvoie. Le champ de résultat `reasoningText` de premier niveau est désormais marqué obsolète au profit de `finalStep.reasoningText`. Ne construisez pas de logique qui suppose la présence du raisonnement.

## Quel modèle choisir ?

| Besoin | Modèle | Contexte |
| --- | --- | --- |
| Appel d’outils, sortie structurée | [`broadnet/glm-5.3`](https://broadrouter.com/fr/models/glm-5.3/) | 1 048 576 |
| Images et outils, arabe | [`broadnet/qwen3.8-27b`](https://broadrouter.com/fr/models/qwen3.8-27b/) | 262 144 |
| Long contexte, forfait | [`broadnet/deepseek-v4.1-flash`](https://broadrouter.com/fr/models/deepseek-v4.1-flash/) | 1 048 576 |
| Appels texte et image bon marché | [`broadnet/gemma-4-26b-a4b`](https://broadrouter.com/fr/models/gemma-4-vl-26b/) | 32 768 |

Les prix par token de chaque modèle figurent sur la [page des tarifs](https://broadrouter.com/fr/pricing/).

## Dépannage

-   **401.** `BROADNET_API_KEY` manque dans l’environnement d’exécution (vérifiez les variables d’environnement chez votre hébergeur), est erronée, expirée, ou son quota de paiement à l’usage est épuisé.
-   **providerOptions ignorées.** La clé doit correspondre au `name` du provider en camelCase. Avec `name: 'broadnet'`, utilisez `providerOptions.broadnet`.
-   **Erreurs de modèle.** L’ID doit correspondre exactement à celui de BroadNet, avec le préfixe `broadnet/`. GLM 5.3, Qwen3.8 27B et DeepSeek V4.1 Flash nécessitent une recharge ; le crédit de départ de $5 couvre Gemma 4 VL 26B et les deux modèles Transcribe.
-   **Texte vide, finishReason « length ».** Le raisonnement a épuisé le budget. Augmentez `maxOutputTokens` ou baissez `reasoningEffort`. [Pourquoi les réponses reviennent vides](https://broadrouter.com/fr/guides/reasoning-tokens-empty-response/).
-   **429 sous charge.** Une clé à l’usage autorise 30 requêtes par minute et 4 requêtes en cours. Les fonctions serverless montent vite en charge : plafonnez la concurrence dans votre application. Voir [codes d’erreur et nouvelles tentatives](https://broadrouter.com/fr/guides/errors-and-retries/).
-   **Agents en parallèle avec une clé de forfait.** Une [session de forfait illimité](https://broadrouter.com/fr/guides/unlimited-llm-api-sessions/) traite une seule requête à la fois. Lancer `Promise.all` sur plusieurs agents demande une session par agent, sinon les requêtes passent en file d’attente.

## Termes de ce guide

[Appel d’outils (tool calling, function calling)](https://broadrouter.com/fr/glossary/tool-calling/)

L’appel d’outils, aussi appelé function calling, est une fonctionnalité des API LLM dans laquelle le modèle renvoie une demande structurée d’exécution d’une fonction définie par le développeur, avec des arguments JSON. L’application exécute la fonction et renvoie le résultat ; le modèle n’exécute jamais de code lui-même.

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

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

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

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

[Sortie structurée (structured output)](https://broadrouter.com/fr/glossary/structured-output/)

La sortie structurée est une fonction des API LLM qui contraint la réponse d’un modèle à un format défini par le développeur, en général un JSON Schema, pour que le code puisse l’analyser de façon fiable. Elle est plus stricte que le mode JSON, qui garantit un JSON valide mais pas une structure précise.

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

[Chat template (modèle de conversation)](https://broadrouter.com/fr/glossary/chat-template/)

Un chat template est la règle de mise en forme, généralement écrite en Jinja et livrée avec le tokenizer d’un modèle, qui convertit une liste de messages de chat avec leurs rôles en la séquence unique de tokens attendue par le modèle, tokens de contrôle spéciaux compris. Un mauvais template peut fortement dégrader les réponses d’un modèle.

## Questions fréquentes

### Faut-il utiliser @ai-sdk/openai ou @ai-sdk/openai-compatible ?

Utilisez @ai-sdk/openai-compatible pour les API tierces compatibles OpenAI. Il appelle l’endpoint chat completions, celui que sert BroadNet Inference.

### Pourquoi le texte généré est-il vide ?

Chez BroadNet, le raisonnement compte dans max\_tokens. Si maxOutputTokens est petit, le modèle peut tout consommer avant que la réponse ne commence. Augmentez-le ou réglez reasoningEffort sur low.

### Comment obtenir l’usage des tokens en streaming ?

Réglez includeUsage sur true en créant le provider. D’après la documentation de l’AI SDK, cela ajoute les données d’usage aux réponses en streaming. La valeur par défaut est false.

### Faut-il une configuration distincte pour chaque modèle BroadNet ?

Non. Un seul provider createOpenAICompatible couvre tous les modèles. Appelez broadnet('model-id') ou broadnet.chatModel('model-id') avec n’importe quel ID de modèle de chat BroadNet.

## Guides associés

-   [Utiliser le SDK Node.js d’OpenAI avec BroadNet Inference](https://broadrouter.com/fr/guides/openai-node-sdk/)
-   [Streamer des chat completions et gérer les connexions coupées](https://broadrouter.com/fr/guides/streaming-chat-completions/)
-   [Pourquoi un modèle de raisonnement renvoie une réponse vide](https://broadrouter.com/fr/guides/reasoning-tokens-empty-response/)
-   [Ajouter BroadNet Inference à opencode comme fournisseur personnalisé](https://broadrouter.com/fr/guides/opencode-custom-provider/)
-   [Tous les outils compatibles avec BroadNet Inference (en anglais)](https://broadrouter.com/integrations/) : SDK, agents de code, interfaces de chat et outils d’automatisation, avec les réglages exacts pour chacun

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-vercel-ai-sdk-openai-compatible&utm_content=page-cta) ·

**Sources**

-   [Documentation de l’AI SDK, providers compatibles OpenAI (consulté le 2026-11-14)](https://ai-sdk.dev/providers/openai-compatible-providers)
-   [Documentation de l’AI SDK, référence de generateText (consulté le 2026-11-14)](https://ai-sdk.dev/docs/reference/ai-sdk-core/generate-text)
-   [npm, paquet @ai-sdk/openai-compatible (3.x, consulté le 2026-11-14)](https://www.npmjs.com/package/@ai-sdk/openai-compatible)
-   [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-vercel-ai-sdk-openai-compatible&utm_content=sources)
