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
- Crea una chiave nella home page e copiala. Inizia con sk_maicode2_.
- Aggiungi saldo con un pagamento una tantum da $5.
- Invia una richiesta con la base URL e la tua chiave.
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."}]
}'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.
API Provider: OpenAI Compatible
Base URL: https://maicode2.com/v1
API Key: sk_maicode2_your_key
Model ID: mai-code-2Apri 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.
{
"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 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 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.
{
"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"
}
}Richieste e risposte non vengono salvate. Conserviamo solo dati di misurazione: modello, token, costo, stato e orario.