Como conectar o OpenCode ao CheapTokens (opencode.json)

Para conectar o OpenCode ao CheapTokens, adicione um provedor personalizado compatível com OpenAI: armazene sua chave de API com /connect (ID do provedor cheaptokens) e depois descreva o provedor em opencode.json com a URL base https://api.cheaptokens.dev/v1. Depois disso, seus modelos CheapTokens aparecem em /models.

Este guia segue a documentação de provedores do OpenCode (página atualizada em 20 de outubro de 2026; verificada em 22 de outubro de 2026). A mesma abordagem funciona para as outras ferramentas desta série: Cline, Aider e Kilo Code.

O que você precisa#

• OpenCode instalado (consulte a documentação para a sua plataforma).
• Uma chave de API do CheapTokens. Crie uma na sua conta e adicione saldo; um único saldo cobre todos os modelos. O básico está na documentação do CheapTokens.
• Os fatos da API:
  • URL base: https://api.cheaptokens.dev/v1
  • compatibilidade: OpenAI Chat Completions e Anthropic Messages
  • ID de modelo usado abaixo: deepseek-ai/DeepSeek-V4-Flash-0731 (contexto de 380K, até 32.768 tokens de saída). Os IDs de modelo estão listados na documentação do CheapTokens: os nomes diferem entre provedores, então copie o ID de lá.

Passo 1. Armazene a chave com /connect#

1. Inicie o OpenCode no seu projeto e execute /connect.
2. Role até Other.
3. Insira um ID de provedor exclusivo: cheaptokens.
4. Cole sua chave de API do CheapTokens.

Este passo apenas armazena a credencial. O OpenCode ainda não conhece o endereço nem os modelos do provedor: é para isso que serve o opencode.json.

Passo 2. Descreva o provedor em opencode.json#

Crie ou edite opencode.json e adicione o provedor. O ID do provedor em provider deve corresponder ao que você inseriu em /connect.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "cheaptokens": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "CheapTokens",
      "options": {
        "baseURL": "https://api.cheaptokens.dev/v1"
      },
      "models": {
        "deepseek-ai/DeepSeek-V4-Flash-0731": {
          "name": "DeepSeek-V4-Flash",
          "limit": {
            "context": 380000,
            "output": 32768
          }
        }
      }
    }
  }
}

O que cada parte faz:

• npm — @ai-sdk/openai-compatible é o pacote para endpoints que usam /v1/chat/completions, que é o que o CheapTokens expõe. (O OpenCode usa @ai-sdk/openai para endpoints construídos sobre /v1/responses.)
• name — o rótulo exibido na interface do OpenCode.
• options.baseURL — o endereço da API do CheapTokens.
• models — indexado pelo ID do modelo; o name dentro é um nome de exibição.
• limit.context / limit.output — opcionais; informam ao OpenCode a janela de contexto do modelo e o comprimento máximo da resposta.

Mantenha a chave em uma variável de ambiente (opcional)#

Se você preferir não manter a chave no armazenamento de credenciais do OpenCode, adicione apiKey ao options com a sintaxe {env:VARIABLE} recomendada pela documentação:

"options": {
  "baseURL": "https://api.cheaptokens.dev/v1",
  "apiKey": "{env:CHEAPTOKENS_API_KEY}"
}

Depois exporte CHEAPTOKENS_API_KEY no seu shell. Não faça commit de uma chave real no repositório. Se você é novo em chaves, leia o que é uma chave de API e como armazená-la com segurança.

Passo 3. Verifique se funciona#

Execute /models e escolha DeepSeek-V4-Flash no provedor CheapTokens. Depois envie um prompt curto, por exemplo: "Resuma o que este repositório faz em três frases." Uma resposta normal significa que a URL base, a chave e o ID do modelo estão todos corretos.

Qual modelo CheapTokens escolher#

Adicione quantas entradas quiser ao models — cada uma é um bloco como o acima, com seu próprio ID.

Para uma sessão do OpenCode, que envia muitas requisições em loop, o DeepSeek-V4-Flash é um bom padrão: a saída é mais barata que o preço de referência do OpenRouter, as respostas podem chegar a 32.768 tokens e o preço não tem horários de pico. O MiniMax-M2.7 também é mais barato que os preços de referência do OpenRouter tanto na entrada quanto na saída. A saída do GLM-5.3-Flash também é mais barata que o preço de referência do OpenRouter. Preços atuais (verificados ao vivo, sem números que fiquem desatualizados):

Para estimar uma sessão de trabalho, por exemplo 20 requisições com 100.000 tokens de entrada e 5.000 de saída cada:

Veja todos os preços e a página do DeepSeek para mais informações.

Se não funcionar#

• O provedor ou os modelos estão faltando em /models. Verifique se opencode.json é um JSON válido (sem vírgulas finais) e se a chave em provider é exatamente o ID que você inseriu em /connect. Se ambos estiverem corretos, reinicie o OpenCode.
• 401 / erro de autenticação. Execute /connect novamente e cole a chave outra vez, ou verifique a variável CHEAPTOKENS_API_KEY no shell onde o OpenCode é iniciado.
• 404 ou "model not found". O ID do modelo em models deve corresponder ao ID do CheapTokens caractere por caractere, incluindo o prefixo do fornecedor (deepseek-ai/…).
• Erros de conexão. A URL base deve terminar com /v1 e não conter nenhum caminho extra. Veja erros de conexão comuns.
• "Not enough tokens". Adicione saldo; veja o que o erro significa.

Próximos passos#

Agora você tem o OpenCode rodando no CheapTokens com um único saldo para todos os modelos. Obtenha uma chave e faça sua primeira chamada na documentação do CheapTokens.