OpenCode con Muapi

Usa modelos de texto de Muapi en OpenCode añadiendo Muapi como proveedor personalizado compatible con OpenAI.

1. Crea una clave y elige un modelo

Crea una clave API en el panel de Muapi y lista los modelos de texto disponibles:

curl -s "https://api.muapi.ai/v1/models?type=text" \
  -H "Authorization: Bearer $MUAPI_API_KEY"

Elige un ID de modelo de la respuesta que tenga capabilities.tools: true. OpenCode necesita compatibilidad con herramientas para editar archivos y ejecutar acciones en la terminal.

2. Añade Muapi como proveedor

Define la variable de entorno MUAPI_API_KEY en el shell desde el que ejecutarás OpenCode. En macOS o Linux:

export MUAPI_API_KEY="your-muapi-api-key"

Añade este proveedor al archivo de configuración opencode.json (del proyecto o global):

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "muapi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Muapi",
      "options": {
        "baseURL": "https://api.muapi.ai/v1",
        "apiKey": "{env:MUAPI_API_KEY}"
      },
      "models": {
        "YOUR_MODEL_ID": {
          "name": "Muapi text model"
        }
      }
    }
  }
}

Sustituye YOUR_MODEL_ID por el ID exacto de la lista de modelos de Muapi. Guarda la clave API en la variable de entorno, no en una configuración compartida o que se vaya a confirmar en el repositorio.

3. Selecciona el modelo

Inicia OpenCode, ejecuta /models y selecciona el modelo del proveedor Muapi. Empieza con una tarea de programación pequeña y comprueba que OpenCode pueda leer y modificar un archivo.

Solución de problemas

  • Si Muapi no aparece en /models, comprueba la sintaxis, el ID exacto del modelo y que OpenCode pueda leer el archivo de configuración.
  • Si hay un error de autenticación, confirma que MUAPI_API_KEY esté definida en el entorno que inicia OpenCode.
  • Si el modelo no puede usar herramientas, elige uno cuya entrada en la lista de modelos de Muapi indique capabilities.tools: true.
  • Las solicitudes con repositorios grandes pueden consumir créditos rápidamente. Empieza con una tarea concreta y revisa el uso en el panel de Muapi.

Consulta la documentación de proveedores de OpenCode para ver las opciones actuales de configuración de proveedores personalizados.