DOCUMENTAÇÃO DA API
Documentação da MAI Code 2 API
A MAI Code 2 API segue o formato OpenAI Chat Completions. Aponte um cliente OpenAI para a base URL abaixo, use sua chave como token bearer e escolha mai-code-2 ou mai-code-2-flash.
Início rápido
- Crie uma chave na página inicial e copie-a. Ela começa com sk_maicode2_.
- Adicione saldo com um pagamento único a partir de $5.
- Envie uma requisição com a base URL e sua chave.
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."}]
}'Use o MAI Code 2 em editores e agentes
Funciona qualquer ferramenta que permita adicionar um provedor compatível com OpenAI. Defina a base URL, cole sua chave e digite o ID do modelo. Uma configuração comum é MAI Code 2 para chat e agentes e MAI Code 2 Flash para autocompletar ou como modelo auxiliar.
API Provider: OpenAI Compatible
Base URL: https://maicode2.com/v1
API Key: sk_maicode2_your_key
Model ID: mai-code-2Abra as configurações da extensão no VS Code e escolha o provedor OpenAI Compatible.
Referência
POST /v1/chat/completions
Cria uma resposta. Campos aceitos: 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 e reasoning_effort. Outros campos são ignorados; n deve ser 1.
Com stream: true a resposta chega como server-sent events e termina com data: [DONE]. Defina stream_options.include_usage para receber um bloco final com a contagem 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
Lista os modelos disponíveis no momento.
curl https://maicode2.com/v1/models -H "Authorization: Bearer $MAICODE2_API_KEY"GET /v1/balance
Retorna o saldo restante em USD da conta dona da chave.
curl https://maicode2.com/v1/balance -H "Authorization: Bearer $MAICODE2_API_KEY"Cobrança
Cada requisição é cobrada do seu saldo em USD pelos tokens usados, com mínimo de $0.001. Antes de começar, o custo da entrada estimada mais max_tokens fica reservado; ao terminar, você paga o uso real e o restante volta na hora. Se o saldo não cobrir max_tokens, a requisição roda com um max_tokens menor; abaixo de 256 tokens ela é recusada com 402. Requisições com falha não são cobradas.
Cada resposta traz o cabeçalho X-Request-Id. Respostas sem streaming também trazem X-Balance-Charged-Usd com a cobrança final.
Ver preços e recargas →Erros e limites
Os erros usam o formato de erro da OpenAI, então os SDKs lançam as exceções de sempre.
{
"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"
}
}Não armazenamos requisições nem respostas. Guardamos só dados de medição: modelo, tokens, custo, status e horário.