---
title: "Pydantic AI avec une base_url compatible OpenAI | BroadRouter"
description: "Faites tourner des agents Pydantic AI sur BroadNet Inference avec OpenAIChatModel et OpenAICompatibleProvider : outils, sortie structurée, profils de modèle."
url: https://broadrouter.com/fr/guides/pydantic-ai-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/pydantic-ai-openai-compatible/) (mis à jour le 2026-11-16).

# Pydantic AI avec BroadNet Inference (OpenAICompatibleProvider)

Mis à jour 2026-11-16

Installez pydantic-ai-slim\[openai\], puis créez un OpenAIChatModel avec un ID de modèle BroadNet comme broadnet/glm-5.3 et un OpenAICompatibleProvider dont l’URL de base est https://inference.broadnet.ai/v1 et la clé d’API votre clé BroadNet. Passez le modèle à Agent. Utilisez OpenAIChatModel, pas le modèle Responses, car BroadNet sert les chat completions. Selon la documentation de Pydantic AI, OpenAIProvider avec base\_url est prévu pour OpenAI.

Pydantic AI est un framework d’agents Python créé par l’équipe de Pydantic. Pour un service sans fournisseur intégré, sa documentation recommande `OpenAICompatibleProvider` avec la `base_url` du service. BroadNet Inference sert des chat completions standard à l’adresse `https://inference.broadnet.ai/v1` : c’est donc la voie à suivre. BroadRouter est le site de BroadNet ; ce guide suit la documentation de Pydantic AI à la version 2.68.

## Installation

```bash
pip install "pydantic-ai-slim[openai]"
export BROADNET_API_KEY='your-broadnet-key'
```

## Connexion

```python
import os
from pydantic_ai import Agent
from pydantic_ai.models.openai import OpenAIChatModel
from pydantic_ai.providers.openai_compatible import OpenAICompatibleProvider

model = OpenAIChatModel(
    'broadnet/glm-5.3',
    provider=OpenAICompatibleProvider(
        'broadnet',
        base_url='https://inference.broadnet.ai/v1',
        api_key=os.environ['BROADNET_API_KEY'],
    ),
)

agent = Agent(model)
result = agent.run_sync('Give me three names for a Go linting tool.')
print(result.output)
```

L’exécution sert de test : une réponse affichée signifie que la clé, l’URL et l’ID du modèle sont corrects.

-   **Le premier argument est l’ID du modèle** envoyé à BroadNet. Reprenez-le exactement, avec le préfixe `broadnet/`.
-   **Le nom du fournisseur** (ici `'broadnet'`) est enregistré sur chaque réponse. La documentation de Pydantic AI conseille de le garder stable, car il détermine quelles données des réponses précédentes sont renvoyées au service.
-   **Restez sur `OpenAIChatModel`.** La documentation de Pydantic AI réserve `OpenAIResponsesModel` aux services qui implémentent la Responses API. BroadNet ne l’indique pas.

## Outils et sortie structurée

```python
from pydantic import BaseModel

class City(BaseModel):
    name: str
    country: str

agent = Agent(model, output_type=City)
print(agent.run_sync('Which city hosts the Burj Khalifa?').output)
```

Utilisez `broadnet/glm-5.3` ou `broadnet/qwen3.8-27b` pour les outils et la sortie structurée ; la documentation de BroadNet n’indique ces deux fonctionnalités que pour ces deux modèles.

## Quand définir un profil de modèle

Pydantic AI choisit un profil de requête d’après le nom du modèle. Si une fonctionnalité est ignorée ou refusée, sa documentation conseille de passer votre propre `OpenAIModelProfile`. Deux réglages sont utiles à connaître pour BroadNet :

```python
from pydantic_ai.profiles.openai import OpenAIModelProfile

model = OpenAIChatModel(
    'broadnet/glm-5.3',
    provider=OpenAICompatibleProvider('broadnet', base_url='https://inference.broadnet.ai/v1', api_key=os.environ['BROADNET_API_KEY']),
    profile=OpenAIModelProfile(
        openai_chat_supports_max_completion_tokens=False,  # send max_tokens, the field BroadNet documents
        openai_supports_strict_tool_definition=False,      # only if strict tool schemas are rejected
    ),
)
```

Passez la limite de sortie via les réglages du modèle, par exemple `agent.run_sync(prompt, model_settings={'max_tokens': 2000})`. Sur DeepSeek V4.1 Flash, GLM 5.3 et Qwen3.8 27B, le raisonnement est décompté de cette limite.

## Quel modèle choisir ?

| Agent | Modèle |
| --- | --- |
| Outils, sortie structurée | `broadnet/glm-5.3` |
| Images ou texte arabe, avec outils | `broadnet/qwen3.8-27b` |
| Longs documents, forfait à prix fixe | `broadnet/deepseek-v4.1-flash` |
| Crédit de départ gratuit | `broadnet/gemma-4-26b-a4b` (contexte de 32 768 tokens) |

[Les prix de chaque modèle](https://broadrouter.com/fr/pricing/).

## Dépannage

-   **401.** La clé est erronée, expirée ou son quota est épuisé.
-   **404 ou modèle introuvable.** `base_url` doit se terminer par `/v1`. Vérifiez l’ID du modèle. Les modèles payants nécessitent une recharge ; le crédit de $5 ne couvre que `broadnet/gemma-4-26b-a4b` et les deux modèles Transcribe.
-   **Sortie vide ou boucle de relances de validation.** Le raisonnement a consommé le budget de sortie. Augmentez `max_tokens`. [Pourquoi les réponses reviennent vides](https://broadrouter.com/fr/guides/reasoning-tokens-empty-response/).
-   **400 sur les définitions d’outils.** Définissez `openai_supports_strict_tool_definition=False` dans le profil, et utilisez un modèle que BroadNet indique avec outils.
-   **429 quand vous lancez des agents en parallèle.** Une clé à l’usage autorise 30 requêtes par minute et 4 requêtes en cours. Voir [codes d’erreur et nouvelles tentatives](https://broadrouter.com/fr/guides/errors-and-retries/).

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

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

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

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

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

[Crédit prépayé (prepaid credit)](https://broadrouter.com/fr/glossary/prepaid-credit/)

Le crédit prépayé est de l’argent versé sur un compte API avant utilisation. Chaque requête déduit son coût du solde, et quand le solde est épuisé, les requêtes facturées s’arrêtent jusqu’à la prochaine recharge. Les dépenses sont ainsi plafonnées à ce que vous avez versé.

## Questions fréquentes

### Pour BroadNet, faut-il utiliser OpenAIProvider ou OpenAICompatibleProvider ?

OpenAICompatibleProvider. La documentation de Pydantic AI indique qu’OpenAIProvider accepte aussi une base\_url, mais qu’il est destiné à OpenAI lui-même ou à un proxy transparent vers OpenAI, et qu’il suppose les modèles et fonctionnalités d’OpenAI.

### Pourquoi OpenAIChatModel et pas le modèle OpenAI par défaut ?

Le modèle OpenAI par défaut de Pydantic AI utilise la Responses API. BroadNet sert les chat completions sur /v1/chat/completions, ce qu’appelle OpenAIChatModel.

### Les outils et la sortie structurée fonctionnent-ils ?

Oui, sur les modèles que BroadNet indique avec outils et sortie structurée : GLM 5.3 et Qwen3.8 27B. La documentation de BroadNet n’indique pas d’outils pour DeepSeek V4.1 Flash : testez d’abord les agents qui en utilisent.

### Comment empêcher Pydantic AI d’envoyer max\_completion\_tokens ?

Passez profile=OpenAIModelProfile(openai\_chat\_supports\_max\_completion\_tokens=False) à OpenAIChatModel. Pydantic AI envoie alors l’ancien champ max\_tokens, celui que décrit la référence de l’API de BroadNet.

## Guides associés

-   [Utiliser le SDK Python d’OpenAI avec BroadNet Inference](https://broadrouter.com/fr/guides/openai-python-sdk/)
-   [Utiliser LangChain avec BroadNet Inference](https://broadrouter.com/fr/guides/langchain-openai-base-url/)
-   [CrewAI avec BroadNet Inference comme endpoint OpenAI personnalisé](https://broadrouter.com/fr/guides/crewai-custom-openai-endpoint/)
-   [Pourquoi un modèle de raisonnement renvoie une réponse vide](https://broadrouter.com/fr/guides/reasoning-tokens-empty-response/)
-   [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-pydantic-ai-openai-compatible&utm_content=page-cta) ·

**Sources**

-   [Documentation de Pydantic AI, Other compatible APIs (Other endpoints, Model profile) (consultée le 2026-11-15)](https://pydantic.dev/docs/ai/models/compatible-apis/)
-   [Documentation de Pydantic AI, modèles OpenAI (consultée le 2026-11-15)](https://pydantic.dev/docs/ai/models/openai/)
-   [PyPI, pydantic-ai 2.68.0, Python 3.11+ (consulté le 2026-11-15)](https://pypi.org/project/pydantic-ai/)
-   [Référence de l’API de BroadNet Inference (consultée le 2026-11-15) (en anglais)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-guides-pydantic-ai-openai-compatible&utm_content=sources)
