---
title: "Vercel AI SDK avec des modèles hébergés en Europe"
description: "Utilisez le fournisseur compatible OpenAI du Vercel AI SDK pour appeler des modèles open-weight traités dans l’UE depuis Next.js, Node.js ou l’edge."
canonical: "https://inference.eu/fr/integrations/vercel-ai-sdk/"
language: "fr"
---

SDK · Vercel AI SDK

# Utiliser le Vercel AI SDK avec des modèles open source hébergés dans l’UE

Le Vercel AI SDK est une boîte à outils TypeScript pour intégrer l’IA dans des applications web et des back-ends. Son fournisseur compatible OpenAI se connecte à inference.eu en quelques lignes : \`generateText\`, \`streamText\`, les outils et les sorties structurées tournent alors sur des modèles open-weight traités dans des centres de données européens.

[Contacter l'équipe](https://inference.eu/fr/contact/)[Configuration](#setup)

1.  01Format d'API: OpenAI
2.  02Centres de données dans l'UE
3.  03Couvert par un seul DPA

## Configuré en quelques minutes

1.  1

    Créez une clé API dans votre compte inference.eu et ajoutez `INFERENCE_EU_API_KEY` à l’environnement de votre serveur, par exemple dans `.env.local`.

2.  2

    Installez les paquets avec `npm install ai @ai-sdk/openai-compatible`.

3.  3

    Créez un fournisseur avec `createOpenAICompatible`, en renseignant `name`, `baseURL` avec l’URL de base d’inference.eu, `apiKey` et `includeUsage`.

4.  4

    Passez `inferenceEu("<identifiant>")` comme `model` à `generateText`, `streamText` ou `generateObject`.

5.  5

    Lancez une courte requête côté serveur pour vérifier la connexion avant de la brancher sur votre interface.

lib/inference-eu.ts

```
import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
import { generateText } from "ai";

export const inferenceEu = createOpenAICompatible({
  name: "inference-eu",
  baseURL: "https://api.inference.eu/v1",
  apiKey: process.env.INFERENCE_EU_API_KEY,
  includeUsage: true,
});

const { text } = await generateText({
  model: inferenceEu("gpt-oss-120b"),
  prompt: "Summarise GDPR Article 28 in two sentences.",
});
console.log(text);
```

## Qu’est-ce que le Vercel AI SDK

L’AI SDK est une bibliothèque TypeScript open source de Vercel. Elle offre une API unique pour la génération de texte, le streaming, les appels d’outils, les sorties structurées et les agents, quel que soit le fournisseur de modèles, ainsi que des hooks d’interface comme `useChat` pour React, Svelte et Vue. Elle fonctionne dans Node.js, les fonctions serverless et les environnements edge.

Les fournisseurs sont des paquets distincts. Le paquet `@ai-sdk/openai-compatible` fonctionne avec toute API au format OpenAI : c’est la voie recommandée vers inference.eu. Vos appels à l’AI SDK restent identiques, seule l’instance du fournisseur change.

## Comment fonctionne la configuration

`createOpenAICompatible` renvoie une fonction fournisseur. `name` l’identifie dans les erreurs et la télémétrie, `baseURL` est l’URL de base d’inference.eu terminée par `/v1`, et `apiKey` est envoyée comme jeton bearer. `includeUsage: true` demande les compteurs de jetons en streaming, pour que `usage` soit renseigné à la fin de `streamText`.

Appelez le fournisseur avec un identifiant pour obtenir un modèle, par exemple `inferenceEu("qwen3-coder-480b-a35b-instruct")`. Placez le fournisseur dans un module exécuté uniquement côté serveur : la clé ne doit jamais atteindre le navigateur. Route handlers, server actions et routes d’API l’importent et diffusent les résultats au client via `useChat` ou votre propre interface.

## Quels modèles choisir

Pour le chat, les résumés et l’extraction, `gpt-oss-120b` est un choix par défaut rapide qui garde un streaming fluide dans l’interface. Pour des agents construits avec des outils et `stopWhen`, choisissez un modèle aux appels d’outils fiables, comme `qwen3-coder-480b-a35b-instruct`, `glm-5.3` ou `kimi-k3`.

`glm-5.3` et `kimi-k3` conviennent aussi aux longs documents et au raisonnement en plusieurs étapes. Si vous utilisez `generateObject` avec un schéma Zod, n’activez `supportsStructuredOutputs: true` qu’après avoir vérifié que le modèle renvoie un JSON valide de façon fiable ; sinon, le SDK guide le modèle par des instructions et valide lui-même le résultat.

## Dépannage

Une erreur 401 signifie que `INFERENCE_EU_API_KEY` n’est pas définie dans l’environnement qui exécute l’appel. Les déploiements serverless et edge doivent avoir la variable dans la configuration de l’hébergeur, pas seulement dans `.env.local`. Une erreur 404 vient le plus souvent d’un chemin en trop dans `baseURL`.

« Model not found » signifie que l’identifiant passé au fournisseur diffère de celui d’inference.eu. Si `usage` est vide après le streaming, ajoutez `includeUsage: true`. Si les appels d’outils sont ignorés, vérifiez que le modèle prend en charge les outils. N’utilisez pas le paquet `@ai-sdk/openai` ici : il vise par défaut l’API Responses d’OpenAI, alors que le fournisseur compatible utilise Chat Completions.

## Garder les données dans l’UE

Avec le fournisseur pointé vers inference.eu, chaque prompt et chaque réponse de votre application sont traités dans des centres de données de l’UE et ne servent jamais à l’entraînement. Nous signons un accord de sous-traitance au titre de l’article 28 du RGPD, publions la liste de nos sous-traitants et facturons en euros.

L’AI SDK n’appelle que le fournisseur configuré. La région d’hébergement compte aussi : exécutez route handlers et fonctions dans une région européenne pour que les prompts ne passent pas par des serveurs situés ailleurs avant de nous parvenir. Si vous activez la télémétrie OpenTelemetry, vérifiez où votre outil de traçage stocke les attributs de prompt et de réponse.

## Vercel AI SDK

Catégorie

SDK

Éditeur

Vercel

Format d'API

OpenAI

Traitement

Centres de données dans l'UE

Site web

[ai-sdk.dev](https://ai-sdk.dev/)

Documentation

[ai-sdk.dev](https://ai-sdk.dev/providers/openai-compatible-providers)

## Vercel AI SDK : questions fréquentes

Les questions que nous posent le plus les achats, les développeurs et les juristes. Il en manque une ? Posez-la-nous directement.

Installez \`@ai-sdk/openai-compatible\` et appelez \`createOpenAICompatible\` avec \`name\`, \`baseURL\` et \`apiKey\`. La fonction renvoyée crée des modèles à partir de leur identifiant, que vous passez à \`generateText\`, \`streamText\` ou tout autre appel de l’AI SDK.

Utilisez \`@ai-sdk/openai-compatible\`. Il s’adresse à Chat Completions, servi par inference.eu pour tous les modèles. Le fournisseur \`@ai-sdk/openai\` est conçu pour la plateforme d’OpenAI et utilise par défaut l’API Responses, un format de requête différent.

Prenez \`gpt-oss-120b\` pour un chat rapide et l’extraction, \`qwen3-coder-480b-a35b-instruct\` pour le code et les agents riches en outils, et \`glm-5.3\` ou \`kimi-k3\` pour les longs documents et le raisonnement en plusieurs étapes. Changer de modèle tient en une ligne.

Oui. \`streamText\` diffuse les jetons d’inference.eu comme d’habitude, et \`toUIMessageStreamResponse\` les transmet à \`useChat\`. Réglez \`includeUsage: true\` sur le fournisseur pour disposer des compteurs de jetons une fois le flux terminé.

Oui. Définissez vos outils avec des schémas Zod, passez-les à \`generateText\` ou \`streamText\` et utilisez \`stopWhen\` pour les boucles en plusieurs étapes. Choisissez un modèle aux appels d’outils fiables, comme Qwen3 Coder 480B, GLM-5.3 ou Kimi K3.

Oui. Le SDK envoie votre schéma et valide la réponse. N’activez \`supportsStructuredOutputs: true\` sur le fournisseur qu’après avoir vérifié que le modèle choisi respecte les schémas JSON de façon fiable : le SDK peut alors utiliser les sorties structurées natives.

L’environnement déployé ne dispose pas de \`INFERENCE\_EU\_API\_KEY\`. Ajoutez la variable dans les réglages d’environnement de votre projet d’hébergement, pour chaque environnement, redéployez, et vérifiez que le module du fournisseur s’exécute côté serveur et non dans le navigateur.

Oui. Le fournisseur compatible s’appuie sur l’API standard \`fetch\` et fonctionne dans les environnements edge. Choisissez une région européenne pour la fonction lorsque votre plateforme le permet, afin que les requêtes soient traitées en Europe avant d’atteindre inference.eu.

Oui, et c’est indispensable. Créez le fournisseur dans un module exécuté uniquement côté serveur et appelez-le depuis des route handlers ou des server actions. Le client utilise \`useChat\` vers votre propre point d’accès et ne voit jamais la clé inference.eu.

Non. Le SDK est une bibliothèque qui appelle directement le fournisseur configuré. Les prompts ne partent ailleurs que si vous ajoutez des services comme des exportateurs de télémétrie ou une passerelle. Votre hébergeur exécute votre code : choisissez sa région avec soin.

[Poser une question](https://inference.eu/fr/contact/)

## Pages liées

[Toutes les intégrations](https://inference.eu/fr/integrations/)

-   [OpenAI SDK (Python and JavaScript)Pointez le SDK OpenAI officiel pour Python ou JavaScript vers inference.eu avec base\_url et une clé API, et appelez des modèles open-weight traités dans l’UE.SDK](https://inference.eu/fr/integrations/openai-sdk/)
-   [MastraPointez vos agents et workflows Mastra vers inference.eu grâce à une URL de modèle personnalisée et faites-les tourner sur des modèles open-weight de l’UE.Frameworks](https://inference.eu/fr/integrations/mastra/)
-   [LangChainConnectez ChatOpenAI de LangChain à inference.eu avec base\_url et faites tourner chaînes, agents et LangGraph sur des modèles open-weight traités dans l’UE.Frameworks](https://inference.eu/fr/integrations/langchain/)

## Faites passer vos charges IA sur une infrastructure européenne

Dites-nous quels modèles vous utilisez et votre volume approximatif. Nous répondons sous un jour ouvré avec un tarif et la suite.

-   Réponse sous un jour ouvré
-   Tarif adapté à votre volume
-   DPA prêt à signer