--- title: "API Responses hébergée en Europe · compatible OpenAI" description: "Utilisez le format de l'API Responses d'OpenAI avec des modèles open-weight sur inference.eu. Sorties typées, outils intégrés, traitement dans l'UE." canonical: "https://inference.eu/fr/api/responses/" language: "fr" --- POST /v1/responses # API Responses : le format Responses d'OpenAI, traité dans l'UE Le point de terminaison Responses est la plus récente des deux API de génération au format OpenAI. Il prend \`instructions\` et \`input\` au lieu d'une liste de messages, renvoie des éléments de sortie typés et c'est là que se configurent les outils intégrés : recherche web, exécution de code et serveurs MCP distants. Pour un nouveau projet ou des agents construits avec l'OpenAI Agents SDK, c'est en général le bon choix. [Contacter l'équipe](https://inference.eu/fr/contact/)[Exemple de requête](#example) 1. 01Format d'API: OpenAI 2. 02Centres de données dans l'UE 3. 03Couvert par un seul DPA POST /v1/responses ``` curl https://api.inference.eu/v1/responses \ -H "Authorization: Bearer $INFERENCE_EU_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-oss-120b", "instructions": "You are a support assistant for a Dutch logistics company. Answer in two short paragraphs.", "input": "A customer says their pallet was delivered to the wrong depot. What should I ask them first?", "max_output_tokens": 500, "reasoning": {"effort": "low"} }' ``` ## Ce que fait le point de terminaison `POST /v1/responses` génère une réponse à partir d'`input`, qui peut être une simple chaîne ou une liste d'éléments : messages, images, sorties précédentes et résultats d'outils. `instructions` contient le prompt système, séparé du contenu de l'utilisateur, ce qui permet de le modifier sans reconstruire l'entrée. La sortie n'est pas un message unique mais un tableau `output`. Une réponse simple contient un élément `message`, alors qu'une étape d'agent peut enchaîner raisonnement, appels de fonctions, recherches web et appels MCP dans l'ordre où ils ont eu lieu. Les SDK OpenAI regroupent le texte dans la propriété `output_text`. ## Les champs essentiels de la requête Seuls `model` et `input` sont obligatoires. `max_output_tokens` plafonne la réponse, tokens de raisonnement compris, et `reasoning.effort` (`low`, `medium` ou `high`) règle l'effort de réflexion d'un modèle de raisonnement. `temperature` et `top_p` fonctionnent comme avec chat completions. `tools` accueille vos propres fonctions ainsi que les types intégrés `web_search`, `code_interpreter` et `mcp`. `text.format` demande un JSON conforme à un schéma. Avec `stream: true`, vous recevez des événements typés comme `response.output_text.delta`, et `previous_response_id` reprend un échange précédent sans renvoyer tout l'historique. ## État de la conversation et stockage Avec chat completions, votre code renvoie tout l'historique. Avec Responses, il suffit de passer `previous_response_id` : l'API reconstitue le contexte à partir de la réponse enregistrée. Les requêtes restent légères dans les longues boucles d'agents et les éléments de raisonnement sont conservés d'une étape à l'autre. Les réponses enregistrées restent dans l'UE et ne servent jamais à l'entraînement. Si vous ne voulez rien conserver, passez `store` à `false` et envoyez l'entrée complète à chaque fois, comme avec chat completions. La durée de conservation dépend de votre contrat et nous la validons avec vous avant la mise en production. ## Erreurs et cas particuliers Vérifiez le champ `status` de chaque réponse. `completed` est le cas normal. `incomplete` signale un arrêt prématuré, et `incomplete_details.reason` précise si `max_output_tokens` a été atteint. Une réponse `failed` contient un objet `error`. Les erreurs HTTP suivent le format habituel : 400 pour une requête invalide, 401 pour une mauvaise clé, 404 pour un modèle ou un identifiant de réponse inconnu, 429 lorsqu'une limite de votre offre est atteinte. Ne supposez pas que le premier élément est le texte. Les modèles de raisonnement placent d'abord un élément `reasoning` : parcourez `output` et filtrez par `type`, ou utilisez `output_text` dans le SDK. ## Responses Endpoint POST /v1/responses Catégorie Endpoints Format d'API OpenAI Base URL api.inference.eu/v1 Traitement Centres de données dans l'UE Entraînement sur vos données Jamais ## Responses : 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. Les formats de requête et de réponse suivent l'API Responses d'OpenAI : \`instructions\`, \`input\`, éléments \`output\` typés, événements de streaming et \`previous\_response\_id\`. Vous pointez le SDK OpenAI vers l'URL de base d'inference.eu et appelez \`client.responses.create\`. Les modèles sont des modèles open-weight traités dans des centres de données de l'UE. Chat completions convient si votre code ou votre framework l'attend déjà : il est sans état et très répandu. Responses est préférable pour les nouveaux agents, les outils intégrés comme la recherche web ou MCP, et les tâches longues en plusieurs étapes où \`previous\_response\_id\` évite de renvoyer tout l'historique. Transmettez l'\`id\` de la réponse précédente dans \`previous\_response\_id\`, avec le nouvel \`input\`. L'API restaure le contexte antérieur, raisonnement compris, et vous n'envoyez que ce qui est nouveau. Avec \`store: false\`, c'est à vous de conserver l'historique et de l'envoyer en entier dans \`input\`. Les réponses enregistrées sont stockées dans des centres de données européens, avec les requêtes correspondantes, et ne servent jamais à entraîner des modèles. Vous pouvez y renoncer requête par requête avec \`store: false\`. La durée de conservation dépend de votre contrat et nous vous la confirmons par écrit. Oui. Avec \`stream: true\`, vous recevez des événements typés, par exemple \`response.created\`, \`response.output\_text.delta\` pour le texte et \`response.completed\` à la fin. Les SDK OpenAI les interprètent pour vous : vous affichez le texte au fil de l'eau et lisez l'objet de réponse complet à la fermeture du flux. Oui. L'Agents SDK s'appuie par défaut sur l'API Responses. Créez un client OpenAI avec l'URL de base et la clé d'inference.eu, déclarez-le comme client par défaut du SDK et choisissez un identifiant de modèle ouvert. Outils de fonction, transferts entre agents et streaming fonctionnent avec le format Responses standard. Le modèle s'est arrêté avant d'avoir terminé. Consultez \`incomplete\_details.reason\` : la valeur \`max\_output\_tokens\` indique une limite trop basse pour la réponse et le raisonnement. Augmentez la limite, baissez \`reasoning.effort\` ou demandez une réponse plus courte, puis relancez la requête. Vous pouvez ajouter vos propres outils \`function\` ainsi que les types intégrés \`web\_search\`, \`code\_interpreter\` et \`mcp\` pour les serveurs MCP distants. Les outils intégrés s'exécutent chez nous, dans l'UE, et leurs appels apparaissent comme éléments typés dans \`output\`. Les outils réservés par OpenAI à ses propres produits ne sont pas disponibles. [Poser une question](https://inference.eu/fr/contact/) ## Pages liées [Présentation de l'API](https://inference.eu/fr/api/) - [Chat completionsEnvoyez vos messages à des modèles open-weight au format chat completions d'OpenAI. Traitement dans des centres de données de l'UE, sans entraînement.Endpoints](https://inference.eu/fr/api/chat-completions/) - [Remote MCP serversConnectez des serveurs MCP distants à vos requêtes avec l'outil mcp de l'API Responses. L'API liste et appelle leurs outils pour vous, dans l'UE.Outils](https://inference.eu/fr/api/mcp/) - [Web searchLaissez les modèles ouverts chercher sur le web pendant une requête grâce à l'outil web\_search de l'API Responses. Réponses à jour, sources citées.Outils](https://inference.eu/fr/api/web-search/) - [Code executionLaissez les modèles ouverts écrire et exécuter du Python en bac à sable grâce à l'outil code\_interpreter de l'API Responses. Analyse de données dans l'UE.Outils](https://inference.eu/fr/api/code-execution/) ## 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