DOCUMENTATION API
Documentation de la MAI Code 2 API
La MAI Code 2 API suit le format OpenAI Chat Completions. Pointez un client OpenAI vers la base URL ci-dessous, utilisez votre clé comme jeton bearer et choisissez mai-code-2 ou mai-code-2-flash.
Démarrage rapide
- Créez une clé sur la page d’accueil et copiez-la. Elle commence par sk_maicode2_.
- Ajoutez du solde avec un paiement unique dès 5 $.
- Envoyez une requête avec la base URL et votre clé.
https://maicode2.com/v1curl https://maicode2.com/v1/chat/completions \
-H "Authorization: Bearer $MAICODE2_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "mai-code-2",
"messages": [{"role": "user", "content": "Write a Python function that checks if a string is a palindrome."}]
}'Utiliser MAI Code 2 dans les éditeurs et les agents
Tout outil qui permet d’ajouter un fournisseur compatible OpenAI fonctionne. Renseignez la base URL, collez votre clé et saisissez l’ID du modèle. Une configuration courante : MAI Code 2 pour le chat et les agents, MAI Code 2 Flash pour l’autocomplétion ou comme modèle auxiliaire.
API Provider: OpenAI Compatible
Base URL: https://maicode2.com/v1
API Key: sk_maicode2_your_key
Model ID: mai-code-2Ouvrez les réglages de l’extension dans VS Code et choisissez le fournisseur OpenAI Compatible.
Référence
POST /v1/chat/completions
Crée une réponse. Champs pris en charge : model, messages, max_tokens ou max_completion_tokens, temperature, top_p, stop, stream, stream_options, tools, tool_choice, parallel_tool_calls, response_format, seed, presence_penalty, frequency_penalty et reasoning_effort. Les autres champs sont ignorés ; n doit valoir 1.
Avec stream: true, la réponse arrive en server-sent events et se termine par data: [DONE]. Activez stream_options.include_usage pour recevoir un dernier bloc avec le nombre de tokens.
{
"model": "mai-code-2",
"messages": [{"role": "user", "content": "What is in src/app.ts?"}],
"tools": [{
"type": "function",
"function": {
"name": "read_file",
"description": "Read a file from the repository",
"parameters": {"type": "object", "properties": {"path": {"type": "string"}}, "required": ["path"]}
}
}]
}GET /v1/models
Liste les modèles disponibles en ce moment.
curl https://maicode2.com/v1/models -H "Authorization: Bearer $MAICODE2_API_KEY"GET /v1/balance
Renvoie le solde restant en USD du compte propriétaire de la clé.
curl https://maicode2.com/v1/balance -H "Authorization: Bearer $MAICODE2_API_KEY"Facturation
Chaque requête est débitée de votre solde en USD selon les tokens utilisés, avec un minimum de 0,001 $. Avant le départ, le coût de l’entrée estimée plus max_tokens est réservé ; à la fin, vous payez l’usage réel et le reste revient aussitôt. Si le solde ne couvre pas max_tokens, la requête s’exécute avec un max_tokens plus petit ; en dessous de 256 tokens elle est refusée avec 402. Les requêtes en échec ne sont pas facturées.
Chaque réponse contient l’en-tête X-Request-Id. Les réponses sans streaming contiennent aussi X-Balance-Charged-Usd avec le montant final.
Voir les prix et les recharges →Erreurs et limites
Les erreurs suivent le format d’erreur OpenAI, donc les SDK lèvent leurs exceptions habituelles.
{
"error": {
"message": "Insufficient balance: this request needs at least $0.004. Add balance at https://maicode2.com/pricing.",
"type": "insufficient_quota",
"param": null,
"code": "insufficient_quota"
}
}Les requêtes et les réponses ne sont pas conservées. Nous gardons seulement des données de mesure : modèle, tokens, coût, statut et heure.