OpenCode con Muapi

Usa i modelli testuali Muapi in OpenCode aggiungendo Muapi come provider personalizzato compatibile con OpenAI.

1. Crea una chiave e scegli un modello

Crea una chiave API nella dashboard Muapi, quindi elenca i modelli testuali disponibili:

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

Scegli un modello la cui risposta includa capabilities.tools: true. OpenCode ha bisogno del supporto agli strumenti per modificare file e agire nel terminale.

2. Aggiungi Muapi come provider

Imposta la variabile d’ambiente MUAPI_API_KEY nella shell da cui avvii OpenCode. Su macOS o Linux:

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

Aggiungi questo provider al file di configurazione opencode.json (di progetto o globale):

{
  "$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"
        }
      }
    }
  }
}

Sostituisci YOUR_MODEL_ID con l’ID esatto dell’elenco Muapi. Mantieni la chiave API nella variabile d’ambiente, non in una configurazione condivisa o versionata.

3. Seleziona il modello

Avvia OpenCode, esegui /models e seleziona il modello sotto il provider Muapi. Inizia con una piccola attività di programmazione e verifica che OpenCode riesca a leggere e modificare un file.

Risoluzione dei problemi

• Se Muapi non compare in /models, verifica la sintassi, l’ID esatto e che OpenCode possa leggere il file di configurazione.
• In caso di errore di autenticazione, verifica che MUAPI_API_KEY sia impostata nell’ambiente che avvia OpenCode.
• Se il modello non usa strumenti, scegline uno con capabilities.tools: true nell’elenco Muapi.
• Prompt con repository grandi possono consumare crediti rapidamente. Inizia con un’attività circoscritta e controlla l’utilizzo nella dashboard Muapi.

Consulta la documentazione dei provider OpenCode per le opzioni di configurazione aggiornate.