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
- Crea una clave en la página de inicio y cópiala. Empieza por sk_maicode2_.
- Añade saldo con un pago único desde $5.
- Envía una petición con la base URL y tu clave.
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 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.
API Provider: OpenAI Compatible
Base URL: https://maicode2.com/v1
API Key: sk_maicode2_your_key
Model ID: mai-code-2Abre 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.
{
"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 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 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.
{
"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"
}
}No guardamos las peticiones ni las respuestas. Solo conservamos datos de medición: modelo, tokens, coste, estado y hora.