Accès API

22 septembre 2026 · AIAdapter · https://www.aiadapter.com

AIAdapter expose une API compatible OpenAI. Un compte délivre une seule clé API. La même clé authentifie chaque requête, qu’il s’agisse d’un client de bureau ou de code applicatif. N’en créez pas une seconde par modèle, fournisseur ou client.

Ne remplacez l’origine ci-dessous que pour un hôte hors production. Le chemin /v1 est obligatoire.

1. Identifiants

Connectez-vous, ouvrez Console → API Keys et créez la clé une seule fois. Le secret n’est affiché qu’à la création ; enregistrez-le immédiatement et réutilisez-le partout.

Les bibliothèques officielles OpenAI ajoutent des chemins tels que /chat/completions à l’URL de base. Pointez le client vers …/v1, pas vers la racine du site.

Traitez la clé comme un secret. Ne la commitez pas, ne la collez pas dans un ticket, ne l’intégrez pas dans du JavaScript navigateur, une application mobile ou tout client inspectable. Chargez-la depuis une variable d’environnement ou un gestionnaire de secrets. En cas d’exposition, supprimez-la et créez un seul remplacement.

2. Accès client direct

Utilisez ce chemin pour appeler des modèles depuis une application déjà compatible OpenAI, sans écrire de code d’intégration. Clients typiques : Cursor, Claude Desktop, Cherry Studio, Continue, LibreChat.

Trois champs suffisent. La clé est celle délivrée dans la console.

Cursor

1. Ouvrez Settings → Models.
2. Collez la clé dans OpenAI API Key.
3. Activez Override OpenAI Base URL et saisissez https://www.aiadapter.com/v1 (v1 en minuscules).
4. Ajoutez l’identifiant du marketplace sous Custom Models. Évitez un ID qui entre en collision avec un modèle intégré à Cursor.

Cursor Tab et certains modèles intégrés n’utilisent pas une URL de base OpenAI personnalisée. Après le remplacement, discutez avec un ID du marketplace. Si un champ n’accepte pas le focus, mettez Cursor à jour vers 3.15.20 ou plus récent.

Autres clients compatibles OpenAI

Dans Claude Desktop, Cherry Studio, Continue, LibreChat, ou tout client acceptant un fournisseur compatible OpenAI :

• Fournisseur / type d’API : OpenAI compatible
• Base URL : https://www.aiadapter.com/v1
• Clé API : la unique clé AIAdapter
• Modèle : l’identifiant du marketplace

N’émettez pas une seconde clé pour un second client. Deux clients avec la même clé constituent la configuration prévue.

3. Intégration applicative

Utilisez ce chemin lorsque vous écrivez un logiciel. Le contrat est identique : une clé, une URL de base, authentification Bearer. Les exemples ci-dessous utilisent les bibliothèques officielles OpenAI comme client interchangeable.

Définissez AIADAPTER_API_KEY dans l’environnement du processus. Ne codez pas le secret en dur. Remplacez MODEL_ID par l’identifiant exact de /models, préfixe vendeur compris.

HTTP

curl https://www.aiadapter.com/v1/chat/completions \
  -H "Authorization: Bearer $AIADAPTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "Reply with one word: ok"}]
  }'

Python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AIADAPTER_API_KEY"],
    base_url="https://www.aiadapter.com/v1",
)
response = client.chat.completions.create(
    model="MODEL_ID",
    messages=[{"role": "user", "content": "Reply with one word: ok"}],
)
print(response.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.AIADAPTER_API_KEY,
  baseURL: "https://www.aiadapter.com/v1",
});
const response = await client.chat.completions.create({
  model: "MODEL_ID",
  messages: [{ role: "user", content: "Reply with one word: ok" }],
});
console.log(response.choices[0].message.content);

4. Modèles et points de terminaison

Listez les modèles avec GET /v1/models et la même clé Bearer, ou parcourez /models. Utilisez l’identifiant listé comme model. Les identifiants portent un préfixe vendeur. Copiez-les tels quels. Exemples : pixverse/c1, byteplus-intl/dreamina-seedance-2-5-260628. N’envoyez pas un nom court comme c1 ou seedance-2.5.

Routes compatibles OpenAI courantes :

• POST /v1/chat/completions — chat et modèles de langage
• POST /v1/images/generations — modèles d’image
• POST /v1/video/generations puis GET /v1/video/generations/{id} — modèles vidéo

Images

La génération d’image est synchrone. Placez l’identifiant du marketplace dans model.

curl https://www.aiadapter.com/v1/images/generations \
  -H "Authorization: Bearer $AIADAPTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "byteplus-intl/dola-seedream-5-0-flash-260915",
    "prompt": "A red paper lantern in rain"
  }'

Vidéo

La soumission renvoie un job. Interrogez le même chemin avec cet identifiant jusqu’au succès ou à l’échec. N’attendez pas le fichier fini sur la requête de soumission.

curl https://www.aiadapter.com/v1/video/generations \
  -H "Authorization: Bearer $AIADAPTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pixverse/c1",
    "prompt": "A cat walking across a sunlit kitchen",
    "seconds": "5"
  }'

curl https://www.aiadapter.com/v1/video/generations/JOB_ID \
  -H "Authorization: Bearer $AIADAPTER_API_KEY"

L’audio et les autres modalités suivent la fiche du modèle sur le marketplace.

Un 401 indique une clé absente ou invalide. Un 429 indique une limitation de débit. Un solde ou quota insuffisant est renvoyé comme erreur API ; créditez la console avant de réessayer.

5. Gestion de la clé

Une clé suffit pour toutes les intégrations du compte. En créer d’autres disperse les journaux d’audit et augmente le risque de fuite ; cela n’ouvre pas de modèles supplémentaires.

Questions : help@aiadapter.com