MCode

DOCUMENTACIÓN API

Documentación de MAI Code 2 API

La MAI Code 2 API sigue el formato de OpenAI Chat Completions. Apunta un cliente de OpenAI a la base URL de abajo, usa tu clave como token bearer y elige mai-code-2 o mai-code-2-flash.

Inicio rápido

  1. Crea una clave en la página de inicio y cópiala. Empieza por sk_maicode2_.
  2. Añade saldo con un pago único desde $5.
  3. Envía una petición con la base URL y tu clave.
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 en editores y agentes

Funciona cualquier herramienta que permita añadir un proveedor compatible con OpenAI. Define la base URL, pega tu clave y escribe el ID del modelo. Una configuración habitual es MAI Code 2 para el chat y los agentes y MAI Code 2 Flash para el autocompletado o 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

Abre la configuración de la extensión en VS Code y elige el proveedor OpenAI Compatible.

Referencia

POST /v1/chat/completions

Crea una respuesta. Campos admitidos: 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 y reasoning_effort. Los demás campos se ignoran; n debe ser 1.

Con stream: true la respuesta llega como server-sent events y termina con data: [DONE]. Activa stream_options.include_usage para recibir un fragmento final con el recuento de tokens.

Cuerpo de petición con llamada a herramientas
{
  "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 los modelos disponibles en este momento.

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

GET /v1/balance

Devuelve el saldo restante en USD de la cuenta dueña de la clave.

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

Facturación

Cada petición se cobra de tu saldo en USD según los tokens que usa, con un mínimo de $0.001. Antes de empezar se retiene el coste de la entrada estimada más max_tokens; al terminar pagas el uso real y el resto se devuelve al instante. Si el saldo no cubre max_tokens, la petición se ejecuta con un max_tokens menor; por debajo de 256 tokens se rechaza con 402. Las peticiones fallidas no se cobran.

Cada respuesta incluye la cabecera X-Request-Id. Las respuestas sin streaming incluyen además X-Balance-Charged-Usd con el cargo final.

Ver precios y recargas →

Errores y límites

Los errores usan el formato de error de OpenAI, así que los SDK lanzan sus excepciones habituales.

400Petición no válida: modelo desconocido, messages mal formado o por encima del límite de entrada.
401Clave de API ausente, mal formada, desconocida o revocada.
402Saldo insuficiente para esta petición. Añade saldo y vuelve a intentarlo.
429Se alcanzó el límite de frecuencia o de concurrencia. Espera lo que indique la cabecera Retry-After.
502El proveedor del modelo devolvió un error. La retención se devuelve.
503El modelo no está disponible temporalmente. No se cobra nada.
Cuerpo del error
{
  "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 petición262,144 tokens
max_tokens predeterminado8,192 tokens
max_tokens máximo32,768 tokens
Peticiones por minuto por clave120
Peticiones simultáneas por cuenta8

No guardamos las peticiones ni las respuestas. Solo conservamos datos de medición: modelo, tokens, coste, estado y hora.