Vue d’ensemble de l’API

Un point d’accès. Deux formats d’échange. Les modèles Claude et GPT actuels. Toute la surface de l’API sur une seule page.

Point d’accès

Toutes les requêtes passent par https://api-ai.fr/v1. Pas de routage régional, pas de sous-domaine par client, pas d’hôte de facturation séparé. La passerelle est hébergée en Europe.

Formats d’échange

API-AI parle deux protocoles sur la même URL. Choisissez celui que votre SDK utilise déjà : les deux sont pris en charge à part entière.

Natif Anthropic. POST /v1/messages — identique octet pour octet à api.anthropic.com. Si votre code appelle Anthropic aujourd’hui, changer base_url constitue toute la migration.
Compatible OpenAI. POST /v1/chat/completions — remplacement direct pour les SDK OpenAI. Appels d’outils, streaming et vision fonctionnent ; seuls les champs sans équivalent côté Claude (par ex. le mode strict response_format=json_schema) sont ignorés sans erreur.

Authentification

Soit Authorization: Bearer mdf-..., soit x-api-key: mdf-.... Jamais les deux dans la même requête — voir Authentification.

Versions

Le chemin est /v1/* sur tous les points d’accès. Les requêtes Anthropic prennent en plus l’en-tête anthropic-version: 2023-06-01 — les SDK l’ajoutent automatiquement.

Nous ne cassons jamais /v1. Les nouvelles fonctionnalités arrivent sous forme de champs additionnels (par ex. les blocs cache_control). Les suppressions ou changements de schéma incompatibles arriveraient sur /v2, avec au moins 90 jours de cohabitation.