Cálculo de Custo

ZippyVendas automaticamente calcula custos para todas as execuções de workflow, fornecendo preços transparentes baseado em uso de modelo de IA e charges de execução. Entender estes custos ajuda você a otimizar workflows e gerenciar seu orçamento efetivamente.

Como os Custos São Calculados

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

Taxa Base de Execução: $0.001 por execução

Uso de Modelo de IA: Custo variável baseado no consumo de tokens

modelCost = (inputTokens × inputPrice + outputTokens × outputPrice) / 1,000,000
totalCost = baseExecutionCharge + modelCost

Breakdown de Modelo em Logs

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

O breakdown de modelo mostra:

• Uso de Tokens: Contagem de tokens de entrada e saída para cada modelo
• Breakdown de Custo: Custos individuais por modelo e operação
• Distribuição de Modelo: Quais modelos foram usados e quantas vezes
• Custo Total: Custo agregado para toda a execução de workflow

Opções de Preço

Estratégias de Otimização de Custo

• Seleção de Modelo: Escolha modelos baseado na complexidade da tarefa. Tarefas simples podem usar GPT-4.1-nano enquanto raciocínio complexo pode precisar de o1 ou Claude Opus.
• Engenharia de Prompt: Prompts bem estruturados e concisos reduzem uso de tokens sem sacrificar qualidade.
• Modelos Locais: Use Ollama ou VLLM para tarefas não-críticas para eliminar custos de API completamente.
• Caching e Reuso: Armazene resultados frequentemente usados em variáveis ou arquivos para evitar chamadas repetidas de modelo de IA.
• Processamento em Batch: Processe múltiplos itens em uma única requisição de IA em vez de fazer chamadas individuais.

Monitoramento de Uso

Monitore seu uso e faturamento em Configurações → Assinatura:

• Uso Atual: Uso em tempo real e custos para o período atual
• Limites de Uso: Limites de plano com indicadores de progresso visual
• Detalhes de Faturamento: Charges projetadas e compromissos mínimos
• Gerenciamento de Plano: Opções de upgrade e histórico de faturamento

Rastreamento de Uso Programático

Você pode consultar seu uso atual e limites programaticamente usando a 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://zippyvendas.com/api/users/me/usage-limits

Exemplo de Resposta:

{
  "success": true,
  "rateLimit": {
    "sync": { "isLimited": false, "limit": 10, "remaining": 10, "resetAt": "2025-09-08T22:51:55.999Z" },
    "async": { "isLimited": false, "limit": 50, "remaining": 50, "resetAt": "2025-09-08T22:51:56.155Z" },
    "authType": "api"
  },
  "usage": {
    "currentPeriodCost": 12.34,
    "limit": 100,
    "plan": "pro"
  }
}

Campos de Resposta:

• currentPeriodCost reflete o uso no período de faturamento atual
• limit é derivado de limites individuais (Free/Pro) ou limites de organização agrupados (Team/Enterprise)
• plan é o plano ativo de maior prioridade associado ao seu usuário

Limites de Plano

Diferentes planos de assinatura têm diferentes limites de uso:

Modelo de Faturamento

ZippyVendas usa um modelo de faturamento assinatura base + overage:

Como Funciona

Plano Pro ($20/mês):

• Assinatura mensal inclui $20 de uso
• Uso abaixo de $20 → Sem charges adicionais
• Uso acima de $20 → Pague o overage no final do mês
• Exemplo: $35 de uso = $20 (assinatura) + $15 (overage)

Plano Team ($40/seat/mês):

• Uso agrupado entre todos os membros do time
• Overage calculado a partir do uso total do time
• Dono da organização recebe uma fatura

Planos Enterprise:

• Preço mensal fixo, sem overages
• Limites de uso customizados por acordo

Faturamento de Threshold

Quando overage não faturado atinge $50, ZippyVendas automaticamente faturas o valor total não faturado.

Exemplo:

• Dia 10: $70 overage → Fatura $70 imediatamente
• Dia 15: Uso adicional de $35 ($105 total) → Já faturado, sem ação
• Dia 20: Outro $50 de uso ($155 total, $85 não faturado) → Fatura $85 imediatamente

Isto espalha charges grandes de overage ao longo do mês em vez de uma grande fatura no final do período.

Melhores Práticas de Gerenciamento de Custo

1. Monitore Regularmente: Verifique seu dashboard de uso frequentemente para evitar surpresas
2. Defina Orçamentos: Use limites de plano como guardrails para seu gasto
3. Otimize Workflows: Revise execuções de alto custo e otimize prompts ou seleção de modelo
4. Use Modelos Apropriados: Corresponda complexidade de modelo aos requisitos de tarefa
5. Faça Batch de Tarefas Similares: Combine múltiplas requisições quando possível para reduzir overhead

Próximos Passos

• Revise seu uso atual em Configurações → Assinatura
• Aprenda sobre Logging para rastrear detalhes de execução
• Explore a API Externa para monitoramento de custo programático
• Veja técnicas de otimização de workflow para reduzir custos