APIMaster.ai
Documentação APIMaster.ai
Quick startAPIMaster.aiMarketplace

OpenCode com APIMaster.ai

Adicione o APIMaster como um provedor compatível com OpenAI no OpenCode Desktop, com níveis opcionais de Raciocínio via opencode.jsonc.

OpenCode Desktop é o cliente gráfico do OpenCode (atualmente em beta): sessões de agente local, edições de arquivos e execução de shell. APIMaster.ai é compatível com OpenAI — adicione-o em Configurações → Provedores → Provedor personalizado.

Obtenha sua Chave de API primeiro. Use o placeholder sua_chave_apimaster abaixo; as capturas de tela ocultam chaves reais.

Pré-requisitos

  1. OpenCode Desktop instalado em opencode.ai/download.
    • Windows: opencode-desktop-win-x64.exe
    • macOS: brew install --cask opencode-desktop ou .dmg
    • Linux: .deb / .rpm / AppImage
  2. Chave de API do APIMaster obtida no console.

Passo 1 — Abrir Provedores

  1. Inicie o OpenCode Desktop e abra um workspace.
  2. Clique no ícone de engrenagem (canto inferior esquerdo).
  3. Selecione Provedores na barra lateral.
  4. Role até Provedor personalizado (Adicionar um provedor compatível com OpenAI pela URL base).
  5. Clique em + Conectar.

Configurações → Provedores → Provedor personalizado

Passo 2 — Formulário do provedor personalizado

Campo Valor
ID do Provedor apimaster
Nome de exibição APIMaster.ai
URL Base https://apimaster.ai/v1
Chave de API Sua chave APIMaster

Formulário do provedor personalizado

Deixe Cabeçalhos vazio, a menos que você autentique apenas por cabeçalhos.

Passo 3 — Adicionar modelos e Enviar

Na próxima tela, mapeie os modelos (esquerda = rótulo no OpenCode, direita = id do modelo enviado ao APIMaster — geralmente o mesmo):

Esquerda Direita
gpt-5.4 gpt-5.4
claude-sonnet-4-6 claude-sonnet-4-6
  1. Clique em + Adicionar modelo para mais linhas.
  2. Clique em Enviar.

Adicionar modelos e Enviar

Escolha os ids no marketplace. Evite modelos apenas de imagem (ex.: gpt-image-2) para chat de agente.

Passo 4 — Escolher um modelo

  1. Inicie ou abra uma sessão.
  2. Abra o menu suspenso de modelos abaixo da entrada.
  3. Em APIMaster.ai, selecione um modelo (ex.: claude-sonnet-4-6).

Seletor de modelo

Passo 5 — Testar

Envie olá ou uma pequena tarefa de codificação. Uma resposta normal do Assistente (edições de arquivo / shell) significa que o APIMaster está conectado.

Teste de chat

Avançado: opencode.jsonc e Raciocínio

O fluxo da interface acima é suficiente para um início rápido. Para configurar níveis de Raciocínio / esforço de pensamento (baixo, alto, máximo, …) para o mesmo id de modelo, edite o opencode.jsonc.

Localização do arquivo de configuração

SO Caminho
macOS / Linux ~/.config/opencode/opencode.jsonc
Windows C:\Users\<nome_de_usuário>\.config\opencode\opencode.jsonc

Crie o arquivo se estiver ausente. Reinicie o OpenCode Desktop ou inicie uma nova sessão após salvar.

Chave de API (não coloque no jsonc)

Não armazene sua Chave de API no opencode.jsonc.

Use:

  • /connect no terminal, ou
  • Configurações → Provedores → Conectar Provedor (mesmo que os Passos 1–2 acima).

Mantenha os segredos no armazenamento de autenticação do OpenCode; o jsonc define apenas provedor, modelos e variantes de Raciocínio.

Provedor APIMaster no jsonc

Id do provedor: apimaster. Pacote npm: @ai-sdk/openai-compatible.

baseURL deve ser:

https://apimaster.ai/v1

Não https://apimaster.ai/ — o OpenCode anexa /chat/completions. Sem /v1 você obtém https://apimaster.ai/chat/completions → 404 Não Encontrado.

Exemplo completo com variantes de Raciocínio — baixe e substitua a configuração do OpenCode:

  1. Baixe opencode.jsonc
  2. Substitua (ou salve como):
    • macOS / Linux: ~/.config/opencode/opencode.jsonc
    • Windows: C:\Users\<nome_de_usuário>\.config\opencode\opencode.jsonc
  3. Configure a Chave de API via /connect ou interface (nunca no jsonc).
  4. Reinicie o OpenCode Desktop ou inicie uma nova sessão.

Faça backup do seu arquivo existente antes de substituir, ou mescle apenas o bloco provider.apimaster.

Estrutura mínima:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "apimaster": {
      "name": "APIMaster.ai",
      "npm": "@ai-sdk/openai-compatible",
      "options": { "baseURL": "https://apimaster.ai/v1" },
      "models": {
        "gpt-5.4": {
          "name": "gpt-5.4",
          "variants": {
            "low": { "reasoningEffort": "low" },
            "high": { "reasoningEffort": "high" }
          }
        }
      }
    }
  }
}

Princípios do Raciocínio

  • variants = múltiplos níveis de Raciocínio para um id de modelo na interface.
  • Para APIs compatíveis com OpenAI, o OpenCode mapeia reasoningEffort → reasoning_effort no corpo da requisição.
  • Os nomes das variantes devem corresponder ao parâmetro real (high → "reasoningEffort": "high").
  • Cada modelo suporta níveis diferentes — configure de acordo com a documentação oficial; sem remapeamento oculto.

Níveis de Raciocínio por modelo

Modelo Variantes de Raciocínio Notas
gpt-5.4 low, medium, high, xhigh Raciocínio GPT
gpt-5.5 low, medium, high, xhigh Raciocínio GPT
deepseek-v4-flash high, max Pensamento DeepSeek (recomendado)
deepseek-v4-pro high, max Pensamento DeepSeek (recomendado)
claude-sonnet-4-6 low, medium, high, max Esforço Claude Sonnet
claude-opus-4-7 low, medium, high, xhigh, max Esforço Claude Opus
claude-opus-4-8 low, medium, high, xhigh, max Esforço Claude Opus
claude-haiku-4-5 nenhum Níveis de esforço não confirmados
minimax-m3 nenhum Níveis de esforço não confirmados

Veja opencode.jsonc para o arquivo completo.

Alternando Raciocínio no OpenCode

  1. Salve opencode.jsonc, depois reinicie ou nova sessão.
  2. Use o menu suspenso de modelo / Raciocínio (ex.: gpt-5.4 / high).
  3. Se suportado em sua versão: Ctrl + Shift + D alterna os níveis de Raciocínio.

Solução de problemas

Configuração pela interface

Problema Solução
401 Verifique a chave; rotacione se exposta
Modelo não encontrado URL Base deve ser https://apimaster.ai/v1; id do modelo deve corresponder ao marketplace
Nenhum modelo APIMaster Edite o provedor em Configurações → adicione mapeamentos → Enviar
Lento / tempo limite Tente outro modelo; use Testador de Chave de API

Raciocínio / jsonc

Por que apenas high e max para DeepSeek?
O esforço de pensamento oficial compatível com OpenAI para DeepSeek é high e max. Evite low / medium / xhigh que podem ser remapeados imprevisivelmente.

Por que max para Claude Sonnet, e não xhigh?
O nível máximo do Sonnet é max; xhigh é para Opus (claude-opus-4-7 / claude-opus-4-8).

Por que nenhuma variante para Haiku ou MiniMax M3?
Sem valores documentados de reasoningEffort, pule as variantes — o modelo ainda funciona; a interface apenas não mostrará subníveis de Raciocínio.

Ainda recebendo erro 400?

  1. baseURL = https://apimaster.ai/v1 (não a raiz do site).
  2. A grafia do id do modelo corresponde ao marketplace.
  3. Chave configurada via /connect ou interface.
  4. Remova variants temporariamente — se as requisições simples funcionarem, o reasoning_effort escolhido pode não ser suportado para aquele modelo.

Segurança

  • Nunca compartilhe chaves em chat ou capturas de tela não editadas.
  • Rotacione chaves que apareceram em capturas de tela ou logs.
  • O OpenCode pode ler/escrever arquivos e executar comandos shell — use apenas workspaces confiáveis.

Lista de verificação

  • OpenCode Desktop instalado
  • Provedor personalizado conectado ou apimaster no opencode.jsonc
  • URL Base / baseURL = https://apimaster.ai/v1 (não https://apimaster.ai/)
  • Chave de API via /connect ou interface (não no jsonc)
  • Pelo menos um modelo de chat mapeado
  • (Opcional) Variantes de Raciocínio correspondem aos níveis oficiais
  • Mensagem de teste bem-sucedida

Resumo

  • Chaves: baseURL (https://apimaster.ai/v1), id do modelo, Chave de API (/connect ou interface), variantes de Raciocínio opcionais.
  • Nomes das variantes = valores reais de reasoning_effort.
  • Configure níveis por modelo; pule variantes quando não suportadas (Haiku, MiniMax M3).

Veja também