Comprueba la versión de OpenCode
Ejecuta primero opencode --version. La configuración siguiente corresponde a OpenCode v1 y su objeto provider. OpenCode v2 utiliza otro esquema; para esa versión, consulta la guía oficial de proveedores v2. No mezcles campos de ambos formatos en un mismo archivo.
Necesitas una clave de MandAPI y un identificador de modelo visible para tu cuenta que admita Chat Completions. Para acciones de programación, confirma también sus funciones de herramientas. Consulta el catálogo actual de MandAPI y sustituye todos los marcadores MODEL_ID por el mismo identificador exacto.
Guarda la credencial
Inicia OpenCode, ejecuta /connect, elige Other y usa mandapi como identificador del proveedor personalizado. Introduce la clave de MandAPI en el formulario de credenciales. Utiliza ese mismo identificador en la configuración siguiente. Mantén la clave fuera del JSON del proyecto y del repositorio.
Añade el proveedor de v1
Crea o combina opencode.json en tu proyecto. Conserva los demás proveedores y ajustes. Esta configuración selecciona el adaptador Chat Completions y define un modelo visible:
{
"$schema": "https://opencode.ai/config.json",
"model": "mandapi/MODEL_ID",
"provider": {
"mandapi": {
"npm": "@ai-sdk/openai-compatible",
"name": "MandAPI",
"options": {
"baseURL": "https://api.mandapi.com/v1"
},
"models": {
"MODEL_ID": {
"name": "Modelo de MandAPI"
}
}
}
}
}mandapi/MODEL_ID es la referencia local de proveedor/modelo de OpenCode. La clave dentro de models sigue siendo el identificador exacto de MandAPI; no le añadas un prefijo propio de OpenRouter. Solo incluye límites de contexto o salida cuando estén comprobados para ese modelo.
Selecciona y prueba el modelo
Ejecuta /models y selecciona la entrada de MandAPI. En un proyecto pequeño, pide un resumen del README en tres frases sin cambiar archivos. Comprueba que llega texto y que MandAPI registra el consumo correspondiente. Continúa con acciones de herramientas después de comprobarlas con el modelo elegido.
Resuelve el problema concreto
Si el proveedor no aparece, comprueba que la credencial y el JSON usan el identificador mandapi, que el archivo es JSON válido y que la versión instalada es v1. Si falla la autenticación, actualiza la credencial guardada en lugar de poner la clave real en el proyecto. Si falla la ruta, revisa la dirección y el adaptador: este ejemplo usa /v1/chat/completions, no el adaptador de Responses. Para restaurar la configuración anterior, selecciona el proveedor previo y recupera la copia de los ajustes del proyecto.