MandAPI
Criar conta
GUIA DE CONEXÃO Em teste

Como usar OpenCode com MandAPI Go

O OpenCode aceita provedores personalizados compatíveis com a API OpenAI. Este guia mostra o formato de configuração esperado para apontar o OpenCode ao endpoint do MandAPI Code Plan e usar os modelos do catálogo inicial.

Última revisão em 22/10/2026. Esta integração está em homologação: a configuração abaixo descreve o formato esperado, mas ainda não foi validada de ponta a ponta com uma chave real do Code Plan.

Ver o Code PlanIr para a solução de problemas

Configuração do provedor personalizado

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "mandapi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "MandAPI Code Plan",
      "options": {
        "baseURL": "https://api.mandapi.com/v1",
        "apiKey": "{env:MANDAPI_CODE_PLAN_KEY}"
      },
      "models": {
        "deepseek-v4-pro-0813": {},
        "deepseek-v4.1-flash": {},
        "deepseek-v4.1-flash-1017": {},
        "kimi-k3": {},
        "kimi-k2.8": {},
        "glm-5.2": {},
        "glm-5.3": {},
        "glm-5.1": {},
        "minimax-m3": {},
        "qwen3.7-max": {},
        "qwen3.8-max": {},
        "mimo-v2.5": {},
        "hy3": {},
        "hy4-preview": {},
      }
    }
  }
}

A chave é lida da variável de ambiente MANDAPI_CODE_PLAN_KEY. Se a sua versão do OpenCode usar providers no plural ou outro pacote de SDK, consulte a documentação da sua versão antes de aplicar este arquivo.

Variável de ambiente

# Linux e macOS
export MANDAPI_CODE_PLAN_KEY="sua-chave-do-code-plan"

# Windows PowerShell
$env:MANDAPI_CODE_PLAN_KEY = "sua-chave-do-code-plan"

Nunca versione a chave. Em CI, use o gerenciador de segredos da plataforma.

Passo a passo

  1. Crie a chave do Code Plan

    No painel da MandAPI, crie uma chave destinada ao Code Plan. Essa chave é marcada para consumir a cota da assinatura e não o saldo pré-pago da API.

  2. Exporte a variável de ambiente

    Defina MANDAPI_CODE_PLAN_KEY no seu shell ou no gerenciador de segredos do sistema. Reinicie o terminal para garantir que a variável esteja disponível.

  3. Adicione o provedor

    Crie ou edite o arquivo de configuração do OpenCode com o bloco acima. Confirme o nome exato do arquivo e a chave de topo aceita pela sua versão.

  4. Selecione um modelo do catálogo

    Use um dos IDs publicados na tabela de referência, como deepseek-v4.1-flash ou glm-5.3. Evite copiar IDs de outros tutoriais, porque a lista muda.

  5. Rode uma tarefa curta

    Comece com uma alteração pequena em um arquivo para validar autenticação, streaming e chamadas de ferramenta antes de pedir uma refatoração grande.

Solução de problemas

401 ou 403 ao chamar o modelo

Verifique se a variável de ambiente está realmente visível para o processo do OpenCode e se a chave pertence ao Code Plan. Uma chave de API pré-paga não consome a cota da assinatura, e uma chave do plano não usa o saldo pré-pago.

O modelo não aparece ou retorna erro de modelo inexistente

Confirme o ID exato na tabela de referência do Code Plan. IDs de outros provedores ou de tutoriais antigos não são aceitos. Se o ID estiver correto e o erro persistir, o modelo pode não estar liberado na sua conta.

As ferramentas do agente não funcionam

Alguns modelos do catálogo podem não suportar o formato de tool calling usado pelo seu agente. Teste outro modelo da lista e registre a combinação que falhou antes de abrir um chamado.

A cota acabou no meio de uma tarefa

O plano para as chamadas quando a cota mensal de valor de referência termina. Não existe recarga automática nem uso do saldo pré-pago sem autorização explícita. A cota volta no próximo ciclo da assinatura.

Dúvidas frequentes

O MandAPI Go funciona com qualquer versão do OpenCode?

Não garantimos compatibilidade com todas as versões. A estrutura de configuração de provedores mudou entre versões do OpenCode, então a configuração precisa ser ajustada à sua versão. Este guia será atualizado após a homologação completa.

Preciso assinar o OpenCode Go para usar o MandAPI Go no OpenCode?

Não. São produtos independentes. O MandAPI Go fornece o acesso aos modelos; o OpenCode é o cliente que faz as chamadas usando a sua chave da MandAPI.

Qual endpoint devo usar?

O endpoint compatível com a API OpenAI é https://api.mandapi.com/v1/chat/completions. A lista de modelos fica em https://api.mandapi.com/v1/models.

Posso usar o mesmo arquivo para Cline ou Continue?

O formato de configuração é diferente em cada cliente. Use o guia específico de cada ferramenta em vez de reaproveitar o arquivo do OpenCode.

Fontes

Entrar na lista do MandAPI Go Ver preços da API por uso