Cálculo de custos

O Zoen calcula automaticamente o custo de cada execução de workflow a partir do uso de modelos de IA mais uma taxa base por execução.

Créditos

O Zoen usa créditos como unidade de medida de todo o uso. 1 crédito = US$ 0,005.

Todos os limites de plano, medidores de uso e limiares de cobrança são exibidos em créditos na UI do Zoen. Valores em dólares nesta documentação são só para referência.

Como os custos são calculados

Toda execução de workflow inclui dois componentes de custo:

Taxa base por execução: 1 crédito (US$ 0,005) por execução

Uso de modelo de IA: Custo variável com base no consumo de tokens

modelCost = (inputTokens × inputPrice + outputTokens × outputPrice) / 1,000,000
totalCredits = baseRunCharge + modelCost × 200

Detalhamento de modelos nos logs

Para workflows que usam blocos de IA, você pode ver informações detalhadas de custo nos logs:

O detalhamento de modelos mostra:

• Uso de tokens: Contagens de tokens de entrada e saída para cada modelo
• Detalhamento de custo: Custos individuais por modelo e operação
• Distribuição de modelos: Quais modelos foram usados e quantas vezes
• Custo total: Custo agregado de toda a execução do workflow

Opções de preço

Preço de ferramentas hospedadas

Quando workflows usam blocos de ferramenta com as chaves de API hospedadas do Zoen, os custos são cobrados por operação. Use suas próprias chaves via BYOK para pagar os provedores diretamente.

Traga sua própria chave (BYOK)

Use suas próprias chaves de API para provedores suportados em vez das chaves hospedadas do Zoen para pagar preços base sem markup.

Provedores suportados

Configuração

1. Vá em Settings → BYOK no seu workspace
2. Clique em Add Key para o seu provedor
3. Informe sua chave de API e salve

Quando configuradas, os workflows usam sua chave em vez das chaves hospedadas do Zoen. Se removidas, os workflows voltam automaticamente às chaves hospedadas com o multiplicador.

Entrada por voz

A entrada por voz usa ElevenLabs Scribe v2 Realtime para transcrição de fala para texto. Está disponível no chat do Mothership e no modo de voz do chat publicado.

Cada sessão de voz é cobrada quando começa. No modo de voz do chat publicado, cada turno da conversa (falar → agente responde → falar de novo) é uma sessão separada. Conversas multi-turno são cobradas por turno.

Planos

O Zoen tem dois tiers de plano pago — Pro e Max. Qualquer um pode ser usado individualmente ou com um time. Planos de time agrupam créditos em todos os assentos da organização.

Para usar Pro ou Max com um time, selecione Get For Team nas configurações de assinatura e escolha o tier e o número de assentos. Os créditos são agrupados na organização na taxa por assento (ex.: Max for Teams com 3 assentos = 75.000 créditos/mês agrupados).

Membros internos da organização usam assentos e contribuem para a alocação agrupada de créditos do time. Membros externos do workspace não entram na sua organização, não aparecem no roster e não contam no total de assentos.

Créditos de refresh diário

Planos pagos incluem uma pequena cota diária de créditos que não conta no limite do plano. A cada dia, o uso até o valor do refresh diário é excluído do uso cobrável. Essa cota reinicia a cada 24 horas e não carrega — use ou perca.

Em planos de time, o refresh diário escala com os assentos (ex.: Max for Teams com 3 assentos = 600 créditos/dia).

Cobrança anual

Todos os planos pagos estão disponíveis com cobrança anual com 15% de desconto. Alterne entre cobrança mensal e anual em Settings → Subscription.

Planos de time seguem o mesmo preço por assento.

Cobrança sob demanda

Por padrão, seu uso é limitado aos créditos incluídos no plano. Para permitir uso além do valor incluído, você pode habilitar a cobrança sob demanda ou editar manualmente o limite de uso para qualquer valor acima do mínimo do plano.

• Enable On-Demand: Remove o teto de uso por completo. Você paga qualquer excedente no fim do período de cobrança.
• Edit Usage Limit: Defina um teto específico acima do valor incluído no plano para controlar quanto excedente você permite.
• Disable On-Demand: Redefine o limite de uso para o valor incluído no plano (só disponível se o uso atual ainda não tiver ultrapassado).

Limites do plano

Workspaces

Planos Team e Enterprise desbloqueiam workspaces compartilhados que pertencem à sua organização. Todo workspace criado sob um plano Team ou Enterprise é da organização: Owners e Admins podem criar workspaces compartilhados ilimitados, enquanto Members da organização não podem criar workspaces (workspaces pessoais criados antes de entrar na organização continuam acessíveis). Membros internos convidados a um workspace compartilhado entram na organização e contam no total de assentos — convites Enterprise exigem um assento disponível no momento do convite, enquanto planos Team adicionam um assento automaticamente quando o convidado aceita. Usuários existentes do Zoen que já pertencem a outra organização podem ser adicionados como membros externos do workspace; eles ganham acesso ao workspace sem entrar na sua organização nem usar um assento. Quando uma assinatura Team ou Enterprise é cancelada ou rebaixada, os workspaces compartilhados existentes continuam acessíveis aos membros atuais, mas novos convites ficam desabilitados até a organização ser atualizada de novo.

Rate limits

Os rate limits seguem o tier pago: Pro e Pro for Teams compartilham os limites Pro, enquanto Max e Max for Teams compartilham os limites Max.

Execuções concorrentes

O limite de concorrência vale por conta de cobrança. Em planos baseados em organização, o limite é compartilhado por todos os workspaces, membros e chaves de API sob aquela organização. Planos Teams seguem o tier: Pro for Teams usa o limite Pro e Max for Teams usa o limite Max. Uma execução async admitida ocupa um slot enquanto está na fila e em execução; execuções síncronas ocupam um enquanto rodam. Blocos workflow-in-workflow executam dentro da execução pai e não consomem outro slot de concorrência.

Armazenamento de arquivos

O armazenamento segue o tier pago: Pro e Pro for Teams compartilham o limite Pro, enquanto Max e Max for Teams compartilham o limite Max. O armazenamento da organização é agrupado entre os workspaces da organização.

Limites de tempo de execução

Execuções sync completam imediatamente e retornam resultados diretamente. São disparadas via API com async: false (padrão) ou pela UI. Execuções async (disparadas via API com async: true, webhooks ou agendamentos) rodam em segundo plano.

Modelo de cobrança

O Zoen usa um modelo de cobrança de assinatura base + excedente:

Como funciona

Plano Pro (US$ 25/mês - 6.000 créditos):

• A assinatura mensal inclui 6.000 créditos de uso
• Uso abaixo de 6.000 créditos → Sem cobranças adicionais
• Uso acima de 6.000 créditos (com sob demanda habilitado) → Pague o excedente no fim do mês
• Exemplo: 7.000 créditos usados = US$ 25 (assinatura) + US$ 5 (excedente de 1.000 créditos a US$ 0,005/crédito)

Planos de time:

• O uso é agrupado entre os membros internos do time na organização
• O uso em um workspace da organização é cobrado na organização daquele workspace, inclusive o trabalho feito por colaboradores externos
• O uso de cada ator autenticado também conta no teto de membro daquela organização
• O excedente é calculado a partir do uso total do time contra o limite agrupado
• O owner da organização recebe uma única fatura

Planos Enterprise:

• Preço mensal fixo, sem excedentes
• Limites de uso personalizados por acordo

Cobrança por limiar

Quando a cobrança sob demanda está habilitada e o excedente não faturado chega a US$ 100, o Zoen fatura automaticamente o valor total não faturado.

Exemplo:

• Dia 10: US$ 120 de excedente → Fatura US$ 120 imediatamente
• Dia 15: Mais US$ 60 de uso (US$ 180 no total) → Já faturado, sem ação
• Dia 20: Mais US$ 80 de uso (US$ 260 no total, US$ 140 não faturados) → Fatura US$ 140 imediatamente

Isso espalha cobranças grandes de excedente ao longo do mês em vez de uma fatura grande no fim do período.

Monitoramento de uso

Monitore seu uso e cobrança em Settings → Subscription:

• Current Usage: Uso de créditos em tempo real no período de cobrança atual
• Usage Limits: Limites do plano com uma barra de progresso visual
• On-Demand Billing: Ative a cobrança sob demanda para permitir uso além dos créditos incluídos no plano
• Plan Management: Faça upgrade, downgrade ou alterne entre cobrança mensal e anual

Acompanhamento programático de uso

Você pode consultar o uso e os limites atuais de forma programática pela API:

Endpoint:

GET /api/users/me/usage-limits

Autenticação:

• Inclua sua chave de API no header X-API-Key

Exemplo de requisição:

curl -X GET -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" https://app.zoen.space/api/users/me/usage-limits

Exemplo de resposta:

{
  "success": true,
  "rateLimit": {
    "sync": {
      "isLimited": false,
      "requestsPerMinute": 150,
      "maxBurst": 300,
      "remaining": 300,
      "resetAt": "2025-09-08T22:51:55.999Z"
    },
    "async": {
      "isLimited": false,
      "requestsPerMinute": 1000,
      "maxBurst": 2000,
      "remaining": 2000,
      "resetAt": "2025-09-08T22:51:56.155Z"
    },
    "authType": "api"
  },
  "usage": {
    "currentPeriodCost": 12.34,
    "limit": 100,
    "plan": "pro_6000"
  }
}

Campos de rate limit:

• requestsPerMinute: Rate limit sustentado (tokens reabastecem a essa taxa)
• maxBurst: Máximo de tokens que você pode acumular (capacidade de burst)
• remaining: Tokens disponíveis no momento (pode chegar a maxBurst)

Campos da resposta:

• currentPeriodCost reflete o uso no período de cobrança atual (em dólares)
• limit deriva de limites individuais (Free/Pro/Max) ou limites agrupados da organização (Team/Enterprise)
• plan é o plano ativo de maior prioridade associado ao seu usuário

Comprando créditos adicionais

Usuários dos planos Pro e Team podem comprar créditos adicionais a qualquer momento em Settings → Subscription → Credit Balance:

• Faixa: US$ 10 a US$ 1.000 por compra
• Conversão: 1 crédito = US$ 0,005 (uma compra de US$ 10 adiciona 2.000 créditos)
• Disponibilidade: Os créditos são adicionados imediatamente após o pagamento
• Expiração: Créditos comprados não expiram
• Reembolsos: Compras não são reembolsáveis
• Planos de time: Só owners e admins da organização podem comprar créditos. Os créditos comprados vão para o pool compartilhado do time.

Estratégias de otimização de custo

• Seleção de modelo: Escolha modelos com base na complexidade da tarefa. Tarefas simples podem usar GPT-4.1-nano; raciocínio complexo pode precisar de o1 ou Claude Opus.
• Engenharia de prompt: Prompts bem estruturados e concisos reduzem o uso de tokens sem sacrificar qualidade.
• Modelos locais: Use Ollama ou VLLM para tarefas não críticas e elimine custos de API por completo.
• Cache e reuso: Armazene resultados usados com frequência em variáveis ou arquivos para evitar chamadas repetidas a modelos de IA.
• Processamento em lote: Processe vários itens em uma única requisição de IA em vez de fazer chamadas individuais.

Próximos passos

• Revise seu uso atual em Settings → Subscription
• Saiba mais sobre Logging para acompanhar detalhes das execuções
• Explore a API externa para monitoramento programático de custos
• Confira técnicas de otimização de workflow para reduzir custos