OpenCode com Muapi

Use modelos de texto da Muapi no OpenCode adicionando a Muapi como provedor personalizado compatível com OpenAI.

1. Crie uma chave e escolha um modelo

Crie uma chave de API no painel da Muapi e liste os modelos de texto disponíveis:

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

Escolha um modelo cuja resposta tenha capabilities.tools: true. O OpenCode precisa de suporte a ferramentas para editar arquivos e executar ações no terminal.

2. Adicione a Muapi como provedor

Defina a variável de ambiente MUAPI_API_KEY no shell em que executará o OpenCode. No macOS ou Linux:

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

Adicione este provedor ao arquivo opencode.json do projeto ou 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" }
      }
    }
  }
}

Substitua YOUR_MODEL_ID pelo ID exato da lista da Muapi. Mantenha a chave na variável de ambiente, nunca em uma configuração compartilhada ou versionada.

3. Selecione o modelo

Inicie o OpenCode, execute /models e selecione o modelo do provedor Muapi. Comece com uma tarefa de programação pequena e confirme que ele consegue ler e alterar um arquivo.

Solução de problemas

• Se a Muapi não aparecer em /models, confira a sintaxe, o ID do modelo e o acesso do OpenCode ao arquivo de configuração.
• Em caso de erro de autenticação, confirme que MUAPI_API_KEY está definida no ambiente que inicia o OpenCode.
• Se o modelo não usar ferramentas, escolha um com capabilities.tools: true na lista Muapi.
• Prompts com repositórios grandes podem consumir créditos rapidamente. Comece com uma tarefa específica e confira o uso no painel Muapi.

Consulte a documentação de provedores do OpenCode para as opções atuais.