Premiers pas

L'utiliser dans une application

Utilisez votre clé dans les applications que vous avez déjà, sans écrire de code. Choisissez l'application, copiez ses paramètres, et c'est terminé. Ces étapes concernent les modèles GPT.

#1. Choisir votre application

Applications de chat et de traduction

Outils de développement

Votre propre code

#2. Copier les paramètres

Cherry Studio

Ouvrir : Settings (设置) → Model Providers (模型服务) → OpenAI

API Key

API Host

Modèle

« API Host » ajoute automatiquement /v1/chat/completions. Arrêtez l'URL à l'hôte (ou à /v1) ; ajoutez # pour désactiver cet ajout automatique.

Protégez votre clé API

Stockez la clé dans une variable d'environnement ou un gestionnaire de secrets. Ne collez jamais de clé permanente dans du code navigateur, des captures d'écran ou un dépôt.

#3. Vérifier que ça fonctionne

  1. Choisissez le modèle dans l'application et envoyez un court message, par exemple « bonjour ».
  2. Une réponse signifie que vous êtes connecté. L'appel apparaît dans Console → Utilisation.
  3. Si l'application rejette la clé, vérifiez si elle attend l'adresse avec ou sans /v1.

#Outils MCP

La connexion aux modèles et MCP se configurent séparément

aisplice fournit la connexion aux modèles. Les serveurs MCP fournissent des outils et des données externes. Configurez le fournisseur aisplice et chaque serveur MCP séparément dans Codex, Cursor ou votre autre client.

Pour Codex, ajoutez un serveur MCP distant avec la CLI ou placez le bloc équivalent dans ~/.codex/config.toml :

Codex MCP
# CLI
codex mcp add my-tools --url https://mcp.example.com/mcp

# equivalent ~/.codex/config.toml
[mcp_servers.my-tools]
url = "https://mcp.example.com/mcp"

L'authentification MCP est distincte

Votre clé API aisplice authentifie uniquement les requêtes de modèles. Suivez les instructions du fournisseur du serveur MCP pour OAuth, les en-têtes ou les variables d'environnement, puis redémarrez le client pour qu'il recharge la configuration.

#Migrer depuis le SDK OpenAI

#Le diff de deux lignes

Pour la plupart des bases de code, c'est toute la PR. Comme le format d'échange est compatible OpenAI, le streaming, l'appel d'outils, la vision et les sorties structurées continuent de fonctionner avec votre code existant.

const client = new OpenAI({
- baseURL: "https://api.openai.com/v1",
+ baseURL: "https://www.aisplice.store/v1",
- apiKey: process.env.OPENAI_API_KEY,
+ apiKey: process.env.GATEWAY_API_KEY,
});

Toujours bloqué ?

Envoyez-nous l'ID de requête ou le message d'erreur, et nous examinerons le problème.