Conecte o DeepSeek Harness à CheapTokens: provedor personalizado

Para usar o DeepSeek Harness com a CheapTokens, abra Settings → Models, mude o cartão para Custom model API, defina a base URL como https://api.cheaptokens.dev/v1, escolha OpenAI Chat Completions como protocolo, cole sua chave CheapTokens e adicione o id do modelo deepseek-ai/DeepSeek-V4-Flash-0731. Selecione esse modelo no seletor e sua próxima sessão roda nele.

Esse é todo o truque. O resto desta página é o formulário exato, uma verificação rápida de que a chave funciona antes de culpar o app, e uma lista curta do que olhar quando o gateway diz não.

As configurações abaixo vêm da documentação do Harness em 24 de outubro de 2026. O projeto está em pré-visualização pública, e seu README avisa que mudanças que quebram compatibilidade vão acontecer, então se um rótulo mudou de lugar, confie na tela e no guia do provedor.

O que você está conectando#

DeepSeek Harness é um agente open-source da DeepSeek (licença MIT, construído sobre a arquitetura de plugins Cordis). Ele vem como app desktop para macOS em Apple silicon e Windows 64-bit, ou como uma web UI que você inicia com npx @deepseek-ai/dsh web (Node.js necessário). A web UI abre em http://127.0.0.1:3080 por padrão.

De fábrica ele pede uma chave DeepSeek. Mas a mesma tela Models tem um cartão para qualquer coisa que não esteja no catálogo dele, um relay, um gateway da empresa ou outro provedor. Esse cartão é o que usamos.

Do lado da CheapTokens você precisa de duas coisas: uma chave e um saldo. Se você ainda não criou uma chave, Sua primeira requisição de API com a CheapTokens leva alguns minutos, e O que é uma chave de API e como armazená-la com segurança cobre onde guardá-la.

Verifique a chave antes de abrir o Harness#

Uma requisição pelo terminal diz se a chave, o saldo e o id do modelo estão certos. Se isso funcionar e o Harness não, o problema está no formulário, não na conta.

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "messages": [{"role": "user", "content": "Say hi in five words."}]
  }'

Você deve receber uma resposta JSON com um array choices e um bloco usage que conta os tokens de entrada e saída. Um erro no estilo Invalid API key significa a chave; uma mensagem sobre o saldo significa que é hora de recarregar.

Preencha o formulário de provedor personalizado#

Abra Settings → Models e mude o cartão do provedor para Custom model API. Preencha os campos assim:

Dois detalhes pegam as pessoas. Primeiro, a base URL é https://api.cheaptokens.dev/v1, exatamente como no curl acima menos /chat/completions. Segundo, o id do modelo é o completo com o prefixo deepseek-ai/. Um nome curto como deepseek-v4-flash não é o que a API espera. Se você quer o contexto sobre base_url e como trocá-la, veja API compatível com OpenAI: o que é base_url e como trocá-la.

Há também um botão Fetch available models. A documentação diz que ele consulta GET /models e que você sempre pode digitar o id à mão. Digitar é o caminho seguro aqui, então faça isso.

Escolha o modelo e rode uma primeira tarefa#

Abra o seletor de modelos e escolha o modelo CheapTokens. Escolher um modelo ali o torna o padrão para novas sessões, então você não precisa repetir.

Agora dê a ele algo pequeno e verificável. Digamos que você tenha um projeto com um teste falhando:

Run the tests, find why test_parse_date fails and fix it. Show me the diff.

O que você quer ver: o agente roda o comando de teste, lê o arquivo que falha, edita-o, roda os testes de novo e mostra um diff. Se ele fizer isso, a conexão está pronta. Seu saldo agora é o que paga pelo loop.

Por que um modelo barato se encaixa num loop de agente#

Um agente não envia uma pergunta. Ele envia a conversa inteira, as listagens de arquivos e a saída das ferramentas de novo a cada passo, então uma sessão é majoritariamente tokens de entrada. É isso que torna as contas de agente surpreendentes (por que um chat longo custa mais explica a mecânica, e Como estimar o custo de um agente de IA dá o método).

Digamos que uma sessão tenha 200 passos, cada passo envia cerca de 30.000 tokens de contexto e recebe cerca de 600 tokens de volta. Isso dá 200 × 30.000 = 6.000.000 tokens de entrada e 200 × 600 = 120.000 tokens de saída. No DeepSeek-V4-Flash essa sessão custa $0.102 aos preços de hoje, e é mais barata que a OpenRouter no total, com entrada e saída contadas juntas. A tabela abaixo usa a mesma carga de trabalho para todo modelo que oferecemos:

Para sessões longas o DeepSeek-V4-Flash oferece uma janela de contexto de 380K, até 32.768 tokens em uma resposta, e um preço a qualquer hora: sem sobretaxa de horário de pico. Ele usa o mesmo saldo que todo outro modelo CheapTokens, então você pode trocar de modelo no Harness sem recarregar de novo. As tarifas atuais estão na página de preços, e a página do modelo tem mais sobre a linha DeepSeek.

Prefere manter a sessão mais leve? Adicione zai-org/GLM-5.3-Flash (contexto de 390K, até 8.192 tokens de saída) ou MiniMaxAI/MiniMax-M2.7 (contexto de 180K, até 8.192 tokens de saída) ao mesmo provedor como ids de modelo extras. Um provedor pode conter vários modelos, e o seletor permite alternar entre eles.

Se não funcionar#

A documentação do Harness lista os suspeitos de sempre. Aqui estão eles com o que fazer:

• O gateway recusa toda requisição embora a chave e a URL estejam certas. O formato da requisição difere do que o endpoint espera. O Harness tem configurações de compatibilidade por modelo, como o papel usado para o prompt de sistema ou o nome do campo de tokens de saída. Elas ficam em $DSH_HOME/profiles/<profile>/cordis.patch.yml e recarregam sem reiniciar. Pegue as chaves exatas do guia do provedor em vez de adivinhá-las.
• O menu de esforço está ausente para o modelo que você digitou. O Harness mostra níveis de raciocínio apenas para modelos que os declaram. Um modelo inserido à mão não tem nenhum declarado, então o menu fica vazio. Declarar níveis faz parte do mesmo arquivo de configurações por modelo.
• 401 ao buscar modelos. Verifique a chave, ou pule o botão e insira o id do modelo você mesmo.
• Uma resposta para no meio da frase. Isso é um limite de tokens, não uma conexão quebrada; veja por que uma resposta de IA para no meio da frase.
• Um 401 ou 403 no log da primeira requisição. Repita a verificação com curl acima com a mesma chave. Se o curl funcionar, digite a chave de novo no campo Credential; um espaço sobrando no final é um clássico.

Se você já usa outro agente com a mesma chave, conectar o OpenCode segue o mesmo padrão, e a documentação da CheapTokens lista todos os endpoints. Mais uma ferramenta na mesma gaveta, um saldo.

Antes de fechar a aba#

• Base URL: https://api.cheaptokens.dev/v1
• Protocolo: OpenAI Chat Completions
• Id do modelo: deepseek-ai/DeepSeek-V4-Flash-0731
• Chave: da sua conta CheapTokens, mantida fora de capturas de tela e repositórios

Rode a tarefa do teste que falha uma vez e acompanhe o uso no seu saldo. Essa única execução diz quanto custam suas próprias sessões.