# Añade MandAPI a OpenCode v1

Configura un proveedor compatible con OpenAI y selecciona tu modelo de MandAPI en OpenCode v1.

## 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](https://opencode.ai/v2/docs/providers). 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](/es/pricing) 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:

```json
{
  "$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.

## Referencias

- [https://docs.opencode.ai/docs/providers/](https://docs.opencode.ai/docs/providers/)
- [https://opencode.ai/v2/docs/providers](https://opencode.ai/v2/docs/providers)