MCode

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

  1. Crie uma chave na página inicial e copie-a. Ela começa com sk_maicode2_.
  2. Adicione saldo com um pagamento único a partir de $5.
  3. Envie uma requisição com a base URL e sua chave.
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."}]
  }'

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.

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

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

Corpo de requisição com chamada de ferramenta
{
  "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
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
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.

400Requisição inválida: modelo desconhecido, messages malformado ou acima do limite de entrada.
401Chave de API ausente, malformada, desconhecida ou revogada.
402Saldo insuficiente para esta requisição. Adicione saldo e tente de novo.
429Limite de taxa ou de concorrência atingido. Aguarde o tempo do cabeçalho Retry-After.
502O provedor do modelo retornou um erro. A reserva é devolvida.
503O modelo está temporariamente indisponível. Nada é cobrado.
Corpo do erro
{
  "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"
  }
}
Entrada por requisição262,144 tokens
max_tokens padrão8,192 tokens
max_tokens máximo32,768 tokens
Requisições por minuto por chave120
Requisições simultâneas por conta8

Não armazenamos requisições nem respostas. Guardamos só dados de medição: modelo, tokens, custo, status e horário.