Custo do OpenHands auto-hospedado: API, sandboxes e planos de nuvem

Um OpenHands auto-hospedado custa $0 pelo software e nada por uma licença — ele é licenciado sob MIT e o repositório está ativo, não arquivado — portanto, o custo real do auto-hospedado são três cobranças separadas: tokens do modelo, a máquina que executa o sandbox e uma chave de pesquisa opcional. O OpenHands não publica nenhum preço para nenhuma das três. O que ele publica, de forma incomum para um agente de programação, é seu próprio repositório de benchmarks, registrando dólares e segundos por tarefa, e este é o parâmetro usado nesta página em vez de estimar quantidades de tokens.

Primeiro, três desambiguações, porque cada uma envia uma dúvida de custo para a página errada. A AI4Bharat mantém outro projeto de código aberto também chamado OpenHands — um kit de ferramentas de reconhecimento de linguagem de sinais cujo banner do repositório informa que ele não é mais mantido ativamente — e nada da documentação dele se aplica aqui. Este produto foi OpenDevin até agosto de 2024 e a empresa era a All Hands AI, portanto qualquer configuração da era OpenDevin foi substituída pela V0. E, embora o site de marketing seja openhands.dev, os serviços em execução ainda estão em all-hands.dev: o aplicativo Cloud está em app.all-hands.dev, e a documentação do provedor informa que, se sua rede tiver restrições de firewall, você deve permitir o domínio all-hands.dev, porque o SDK se conecta a llm-proxy.app.all-hands.dev.

Preços do OpenHands: o que a própria empresa cobra

Lido em openhands.dev/pricing em 21 de setembro de 2026. Não há assinatura individual paga, e a linha de recursos de cada nível oferece o uso da sua própria chave: o FAQ informa "Sim! Os planos OpenHands Open Source e OpenHands Cloud oferecem suporte para trazer suas próprias chaves de LLM." Dois pontos amplamente divulgados fora do site são não encontrados em nenhuma página oficial que localizamos naquele dia — um plano Growth pago e $20 em créditos gratuitos para novos usuários do Cloud. Considere ambos desatualizados até que o OpenHands os publique novamente.

Um número de fonte oficial contraria a palavra Grátis, e é o piso honesto: a documentação de chaves de API afirma: "Você deve comprar pelo menos $10 em créditos do OpenHands Cloud antes de gerar uma chave de LLM do OpenHands." As duas coisas são verdadeiras. O cliente e o nível são gratuitos; o provedor do modelo deles começa com uma compra pré-paga de $10. Usar sua própria chave elimina totalmente esse piso e transfere toda a cobrança para o seu provedor.

As três cobranças por trás de "auto-hospedado"

O OpenHands V1 se divide em três componentes que falham e geram cobranças de forma independente, segundo sua página de arquitetura: Agent Canvas, o cliente do navegador, que essa página afirma explicitamente que "não é um runtime de agente nem um sandbox"; Agent Server, que executa conversas e ferramentas; e o workspace ou sandbox, descrito apenas como "Específico da implantação". Essa divisão explica por que um único valor mensal nunca responde a esta pergunta.

Também não interprete nada disso como uma única "versão atual". Quatro superfícies divergem, e cada número pertence a uma delas: os releases do GitHub estão em v1.20.0 (17 de setembro de 2026), o pacote CLI openhands do PyPI está em 1.16.0, enviado em 8 de maio de 2026, o openhands-sdk do PyPI está em 1.49.2, enviado em 17 de setembro de 2026, e a documentação de configuração local fixa suas próprias tags de imagem Docker. Fixe a superfície que você realmente implanta.

A linha da máquina, precificada segundo o dimensionamento do próprio OpenHands

O OpenHands é incomumente específico aqui: seu guia do backend de VM afirma que "Ubuntu 24.04 LTS com 2 vCPU e 4 GB de RAM é suficiente para um único usuário". Essa classe tem um preço publicado em dois grandes provedores — um DigitalOcean Basic Droplet com 4 GiB de memória, 2 vCPU, SSD de 80 GiB e transferência de 4.000 GiB por $24.00 por mês, $0.03571 por hora (DigitalOcean) e um pacote AWS Lightsail Linux com 4 GB de memória, 2 vCPUs, SSD de 80 GB e transferência de 4 TB por $24 por mês (Lightsail). Estes são preços de terceiros para uma máquina que você escolhe, não preços do OpenHands.

Coloque essa tarifa horária ao lado dos tempos médios de execução publicados pelo próprio OpenHands e o formato da cobrança se torna evidente. Os valores abaixo são uma estimativa: pressupõem uma conversa por vez em uma VM sempre ligada e ignoram downloads de imagens, tempo ocioso entre turnos, armazenamento e transferência.

Os tokens superam o custo computacional em todas as linhas, mas não por um fator constante: a proporção vai de cerca de 16× na linha do MiniMax-M3 SWE-bench a aproximadamente 475× na linha do claude-opus-4-8, porque o modelo barato também é o lento. A máquina não é gratuita, porém — é um piso mensal fixo cobrado independentemente de você executar algo, o formato de cobrança oposto ao dos tokens. Duas consequências que vale a pena considerar no projeto. Primeiro, a VM só compensa acima de certo volume: na repricificação do catálogo mais abaixo, $24 de máquina equivale a aproximadamente 46 tarefas do tamanho do SWE-bench em gasto de modelo; abaixo disso, o custo fixo predomina. Segundo, a capacidade é mais limitada do que o preço sugere — a página do sandbox Docker do OpenHands alerta que o modo de rede do host vincula cada sandbox às mesmas portas fixas do host, portanto "Apenas um sandbox pode ser executado por vez; conversas simultâneas entrarão em conflito nessas portas." Observe também que o termo voltado ao usuário agora é sandbox, enquanto a opção de configuração ainda é RUNTIME — a visão geral dos sandboxes lista docker (padrão), process e remote como valores legados — portanto, pesquise pelas duas palavras.

Executar também o modelo nessa máquina é uma compra diferente. A página de LLM local do OpenHands declara seu requisito de hardware para um modelo específico — Qwen3.6-35B-A3B, o modelo que a página recomenda para programação — como "uma GPU recente com pelo menos 24 GB de VRAM para variantes quantizadas, ou várias GPUs para precisão completa e janelas de contexto maiores, ou um Mac com Apple Silicon com pelo menos 64 GB de memória unificada para variantes quantizadas", além de OLLAMA_CONTEXT_LENGTH definido como pelo menos 22.000 no Ollama. Um modelo local menor pode muito bem precisar de menos; o OpenHands não publica um piso para modelos locais em geral. De qualquer forma, isso é capital de hardware, não um droplet de $24.

Custo da API do OpenHands: os únicos valores de primeira parte por tarefa

Nenhuma página do OpenHands publica tokens por tarefa, por conversa ou um tamanho médio de contexto — portanto, qualquer exemplo de contagem de tokens é uma suposição. Seu repositório de resultados do Index publica dólares e segundos, o que é mais sólido. Buscamos os sidecars de 500 linhas do SWE-bench para quatro modelos e os recalculamos; as médias e as taxas de resolução reproduzem os valores publicados, o que valida interpretar cost_per_instance como o custo médio da API por instância de benchmark.

A distribuição importa mais do que a média. No claude-opus-4-8, o custo mediano da instância é $0.3877, contra uma média de $0.7418, e o custo da pior instância individual é $8.35 — cerca de onze vezes a média. Faça o orçamento considerando a cauda, não a média. Três ressalvas sobre a tabela inteira: o último push no repositório ocorreu em 8 de julho de 2026, portanto essas execuções têm aproximadamente dois meses e meio; cada linha foi executada na sua própria versão registrada do agente, portanto as linhas não constituem uma comparação direta controlada; e estas são instâncias de benchmark, não o seu repositório.

O menor preço listado e o menor custo para concluir a tarefa são afirmações diferentes, e esta tabela as separa. O MiniMax-M3 tem a menor tarifa por token do grupo e o menor custo médio por instância, aproximadamente um quinto do claude-opus-4-8 — mas resolveu 76.4 por cento contra 83.8 por cento, portanto parte dessas tentativas baratas não produziu resultado e precisa ser executada novamente ou concluída manualmente. O GPT-5.5 segue na direção oposta: o dobro do custo médio do claude-opus-4-8 para 5.6 pontos a menos de resolução. A regra que permanece é pouco glamourosa — selecione o modelo menos caro que conclui seu trabalho com um esforço de revisão que você aceita e, em seguida, leia a cobrança registrada pela sua própria conta para uma tarefa delimitada.

O teto está no benchmark commit0, em que uma única tarefa chega a valores de um dígito em dólares — e em que a coluna da máquina mostra quão pouco custa a diferença de tempo de execução quando apenas uma conversa é executada por vez.

O OpenHands é franco sobre o motivo: sua página de LLM afirma que ele "exige um modelo poderoso para funcionar" e alerta que ele "enviará muitos prompts ao LLM que você configurar". O controle oferecido é uma interrupção rígida, não uma previsão: Settings > Application contém um Maximum Budget Per Conversation em USD, e essa página informa que o OpenHands "interromperá a conversa quando o orçamento for atingido, mas você poderá optar por continuar a conversa com um prompt". Portanto, é uma interrupção por conversa que você pode substituir, não um teto mensal.

Reprecificando esse benchmark às tarifas do catálogo

Este é o único lugar em que os valores publicados são transferidos sem uma estimativa de tokens. O metadata.json do OpenHands para claude-opus-4-8 registra os preços exatos usados para calcular o custo da execução — e a Kunavo lista esse mesmo ID de modelo.

Como as quatro classes chegam hoje ao mesmo fator, a execução publicada é reprecificada por esse fator sem precisar das contagens de tokens que ninguém publica. A instância média do SWE-bench passa de $0.7418 para $0.5193, a mediana de $0.3877 para $0.2714 e a pior instância de $8.35 para $5.84. Esta é uma reprecificação do benchmark de outra pessoa, não um custo de tarefa medido no seu repositório — a versão do agente, a combinação de prompts e o comportamento do cache teriam de coincidir.

Para um formato de conversa em vez de um benchmark, eis a aritmética simples de tokens. Suposição nossa, não do OpenHands: uma conversa envia 800k tokens de entrada ao longo dos turnos, à medida que o contexto é reenviado, e recebe 30k tokens de saída, sem contar ocorrências de cache. As tarifas são preços atuais do catálogo da Kunavo.

Aritmética ilustrativa de tokens, não um custo de tarefa medido nem um teto de cobrança — dimensione-a pelo seu próprio número de conversas por dia antes de tratá-la como orçamento. O valor do catálogo da Kunavo é um piso de cobrança, não um limite: quando o upstream informa sua cobrança, a fatura é o maior valor entre o custo do catálogo e o custo do upstream multiplicado pela margem aplicável. O recarregamento mínimo é $10 em crédito pré-pago, que é um mínimo de financiamento, não uma assinatura nem uma tarifa por tarefa — consulte detalhes de cobrança.

Melhor API para o OpenHands: qual rota vence em cada situação

Uma ressalva antes de escolher a rota "a preço de custo" apenas pelo preço: as próprias duas páginas do OpenHands descrevem catálogos diferentes. Sua visão geral de LLM recomenda claude-opus-4-8 (média do Index 71.9), GPT-5.5 (65.9) e Gemini-3.5-Flash (62.6), enquanto a tabela de preços do provedor na página irmã lista 15 IDs de geração anterior — os mais recentes de cada fornecedor são claude-sonnet-4-5-20250929 e claude-opus-4-1-20250805, gpt-5-codex e gpt-5-2025-08-07, o3 e gemini-3-pro-preview — e não contém nenhum desses três. Ambas foram consultadas em 21 de setembro de 2026. Não conseguimos estabelecer se a tabela está desatualizada ou se o catálogo é realmente tão antigo, portanto verifique o que o provedor efetivamente oferece no checkout antes de fazer o orçamento com base na observação de que "Os preços listados refletem as tarifas do provedor sem margem de lucro".

Quatro limites determinam em qual dessas opções você realmente está, e cada um é uma bifurcação de atribuição de custo. O crítico é condicionado. A documentação do crítico do OpenHands informa que o recurso experimental de crítico é "ativado automaticamente" para usuários do OpenHands LLM Provider e é "gratuito durante a fase beta pública" para eles; ele é um segundo endpoint, portanto uma chave de agente de terceiros não o proíbe, simplesmente significa que nenhum está configurado para você. O refinamento iterativo é desativado por padrão e, quando ativado, a configuração Max Iterations assume 3 por turno do usuário e aceita 1–10 — um multiplicador real, apenas nessa rota. As conexões de provedores invertem o bloqueio usual do plano: a página de configuração do modelo informa que o painel reutilizável de chave e URL base está "disponível em backends locais do Agent Server" e "oculto ao usar um backend do OpenHands Cloud", portanto o auto-hospedado obtém esse recurso e o Cloud não. Os perfis têm limite: a página de configurações de LLM informa: "Você pode salvar até 10 perfis de LLM por conta." E um perfil salvo é validado antes de persistir — a página de perfis informa que uma chave rejeitada ou um modelo indisponível impede o salvamento e exibe o erro do backend, embora também observe que backends mais antigos sem o endpoint de validação ignoram a verificação e salvam mesmo assim.

A Kunavo não oferece modelo de embeddings, modelo de conversão de texto em fala nem modelo de conversão de fala em texto, portanto um endpoint aqui responde a conclusões de chat e a nada mais — o que importa porque o OpenHands menciona LLM_EMBEDDING_MODEL entre seus extras definidos apenas por ambiente, e essa configuração não tem uma contraparte para apontar.

No próprio endpoint, o prefixo do modelo e a URL base são uma única decisão, e o OpenHands os documenta por exemplo, não por regra. Sua página de configuração do modelo orienta inserir openai/<served-model-id> para um servidor compatível com OpenAI e mostra uma URL base terminada em /v1; sua página do proxy LiteLLM orienta inserir litellm_proxy/<model-name> e mostra uma origem de proxy simples, sem caminho. Nenhuma página informa o que acontece se você combinar um prefixo com o formato de URL do outro, portanto copie o formato da página correspondente ao seu prefixo e verifique a resposta em vez de presumir. Separadamente, a página do provedor OpenHands informa que o prefixo openhands/ "instrui o SDK a encaminhar automaticamente as solicitações para o proxy LLM do OpenHands — não é necessário definir manualmente uma URL base"; essa frase se refere ao SDK, não ao painel de configurações do Agent Canvas. A configuração completa, campo a campo, está na página de integração do OpenHands; crie uma conta Kunavo quando estiver pronto para financiar uma chave, depois execute uma tarefa delimitada e leia a cobrança registrada pela sua conta.

A Kunavo não testou o OpenHands em tempo de execução contra seu endpoint — nenhuma conversa, nenhum turno transmitido, nenhuma interação de ferramenta de ida e volta, nenhuma versão fixada do cliente. Tudo acima foi lido na documentação, nos repositórios e nos índices de pacotes do próprio OpenHands. Mantenha uma rota funcional disponível enquanto você testa. Comparando clientes em vez de provedores? OpenHands vs Claude Code aborda o fluxo de trabalho e a divisão de sandbox, OpenHands vs OpenCode a alternativa de terminal, e otimização de custos de IA o método para medir tudo isso no seu próprio repositório.

Perguntas frequentes

Verificado novamente nas próprias fontes em 21 de setembro de 2026: openhands.dev/pricing, o registro da API do GitHub para OpenHands/OpenHands e seus três releases mais recentes, PyPI openhands e openhands-sdk, a documentação de chaves de API e da visão geral de LLM, a tabela de preços do provedor LLM do OpenHands, o guia de dimensionamento de VM, os preços de droplets da DigitalOcean e o repositório de resultados do Index — incluindo os sidecars de 500 linhas do SWE-bench para quatro modelos, cujas médias e taxas de resolução foram recalculadas aqui. O bloqueio do crítico, as conexões de provedores, o limite de perfis e a validação antes do salvamento, a exceção do ACP, as páginas de sandbox, orçamento e LLM local e os preços da Tavily e do Lightsail foram relidos no mesmo dia nas páginas indicadas no texto. As tarifas de tokens da Kunavo foram lidas do catálogo ativo; todo exemplo em dólares é uma aritmética ilustrativa, não um custo de tarefa medido.