MCode

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

  1. Créez une clé sur la page d’accueil et copiez-la. Elle commence par sk_maicode2_.
  2. Ajoutez du solde avec un paiement unique dès 5 $.
  3. Envoyez une requête avec la base URL et votre clé.
Base URL
https://maicode2.com/v1
cURL
curl 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.

Cline / Roo Code / Kilo Code
API Provider:  OpenAI Compatible
Base URL:      https://maicode2.com/v1
API Key:       sk_maicode2_your_key
Model ID:      mai-code-2

Ouvrez 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.

Corps de requête avec appel d’outil
{
  "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
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
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.

400Requête invalide : modèle inconnu, messages mal formés ou limite d’entrée dépassée.
401Clé API absente, mal formée, inconnue ou révoquée.
402Solde insuffisant pour cette requête. Rechargez et réessayez.
429Limite de débit ou de concurrence atteinte. Attendez la durée indiquée par l’en-tête Retry-After.
502Le fournisseur du modèle a renvoyé une erreur. La réserve est restituée.
503Le modèle est temporairement indisponible. Rien n’est facturé.
Corps de l’erreur
{
  "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"
  }
}
Entrée par requête262,144 tokens
max_tokens par défaut8,192 tokens
max_tokens maximum32,768 tokens
Requêtes par minute et par clé120
Requêtes simultanées par compte8

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.