MCode

DOCUMENTAZIONE API

Documentazione della MAI Code 2 API

La MAI Code 2 API segue il formato OpenAI Chat Completions. Punta un client OpenAI alla base URL qui sotto, usa la tua chiave come token bearer e scegli mai-code-2 o mai-code-2-flash.

Avvio rapido

  1. Crea una chiave nella home page e copiala. Inizia con sk_maicode2_.
  2. Aggiungi saldo con un pagamento una tantum da $5.
  3. Invia una richiesta con la base URL e la tua chiave.
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."}]
  }'

Usa MAI Code 2 negli editor e negli agenti

Funziona qualsiasi strumento che consenta di aggiungere un provider compatibile con OpenAI. Imposta la base URL, incolla la chiave e scrivi l’ID del modello. Una configurazione tipica è MAI Code 2 per chat e agenti e MAI Code 2 Flash per il completamento automatico o come modello ausiliario.

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

Apri le impostazioni dell’estensione in VS Code e scegli il provider OpenAI Compatible.

Riferimento

POST /v1/chat/completions

Crea una risposta. Campi supportati: model, messages, max_tokens o max_completion_tokens, temperature, top_p, stop, stream, stream_options, tools, tool_choice, parallel_tool_calls, response_format, seed, presence_penalty, frequency_penalty e reasoning_effort. Gli altri campi vengono ignorati; n deve essere 1.

Con stream: true la risposta arriva come server-sent events e termina con data: [DONE]. Imposta stream_options.include_usage per ricevere un blocco finale con il conteggio dei token.

Corpo della richiesta con chiamata di strumenti
{
  "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

Elenca i modelli disponibili in questo momento.

cURL
curl https://maicode2.com/v1/models -H "Authorization: Bearer $MAICODE2_API_KEY"

GET /v1/balance

Restituisce il saldo residuo in USD dell’account che possiede la chiave.

cURL
curl https://maicode2.com/v1/balance -H "Authorization: Bearer $MAICODE2_API_KEY"

Fatturazione

Ogni richiesta viene addebitata sul saldo in USD in base ai token usati, con un minimo di $0.001. Prima dell’avvio viene trattenuto il costo dell’input stimato più max_tokens; alla fine paghi l’uso reale e il resto torna subito. Se il saldo non copre max_tokens, la richiesta parte con un max_tokens più piccolo; sotto i 256 token viene rifiutata con 402. Le richieste fallite non vengono addebitate.

Ogni risposta include l’intestazione X-Request-Id. Le risposte senza streaming includono anche X-Balance-Charged-Usd con l’addebito finale.

Vedi prezzi e ricariche →

Errori e limiti

Gli errori usano il formato di errore di OpenAI, quindi gli SDK sollevano le solite eccezioni.

400Richiesta non valida: modello sconosciuto, messages malformato o oltre il limite di input.
401Chiave API mancante, malformata, sconosciuta o revocata.
402Saldo insufficiente per questa richiesta. Ricarica e riprova.
429Raggiunto il limite di frequenza o di concorrenza. Attendi quanto indicato dall’intestazione Retry-After.
502Il provider del modello ha restituito un errore. L’importo trattenuto viene restituito.
503Il modello non è temporaneamente disponibile. Non viene addebitato nulla.
Corpo dell’errore
{
  "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"
  }
}
Input per richiesta262,144 token
max_tokens predefinito8,192 token
max_tokens massimo32,768 token
Richieste al minuto per chiave120
Richieste simultanee per account8

Richieste e risposte non vengono salvate. Conserviamo solo dati di misurazione: modello, token, costo, stato e orario.