Files
upstream-mirror e7da97194a
Some checks failed
App Prod-Parity E2E Dispatch / dispatch (push) Failing after 10s
CD Storybook UI / build (push) Failing after 3m25s
CD Storybook UI / dispatch (push) Has been skipped
CD deploy main / website-changed-files (push) Successful in 18m8s
CI Agent Skills / changed-files-check (push) Successful in 18m9s
CI Create App E2E minimal / changed-files-check (push) Successful in 24s
CI Create App / changed-files-check (push) Successful in 26s
CI Docs / changed-files-check (push) Successful in 26s
CI Emails / changed-files-check (push) Successful in 28s
CI Example App Hello World / changed-files-check (push) Successful in 23s
CI Front / changed-files-check (push) Has been skipped
CI Example App Postcard / changed-files-check (push) Successful in 27s
CI UI / changed-files-check (push) Has been skipped
CI Utils Test / changed-files-check (push) Successful in 45s
CI Twenty Apps / discover (push) Successful in 1m3s
CD deploy main / deploy-main (push) Failing after 3s
CI Agent Skills / agent-skills-validate (push) Has been skipped
CI Create App / create-app-test (lint) (push) Has been skipped
CI Emails / emails-test (push) Has been skipped
CI Front / front-task (lingui:compile) (push) Has been skipped
CI Front / front-task (lint) (push) Has been skipped
CI Example App Postcard / example-app-postcard (push) Has been skipped
CI UI / ui-task (lint) (push) Has been skipped
CI UI / ui-task (pack-size) (push) Has been skipped
CI UI / ui-task (size) (push) Has been skipped
CI UI / ui-task (test) (push) Has been skipped
CI UI / ui-task (typecheck) (push) Has been skipped
CI Utils Test / utils-test (push) Has been skipped
CI Twenty Apps / ${{ matrix.app.name }} (push) Has been skipped
CI Emails / ci-emails-status-check (push) Successful in 2s
CI Example App Hello World / ci-example-app-hello-world-status-check (push) Successful in 2s
CI Example App Postcard / ci-example-app-postcard-status-check (push) Successful in 3s
CI UI / ui-sb-test (push) Has been skipped
CI Utils Test / ci-utils-test-status-check (push) Successful in 2s
CI Twenty Apps / ci-twenty-apps-status-check (push) Successful in 2s
CI UI / ci-ui-status-check (push) Successful in 2s
CI Desktop / desktop (push) Failing after 1m8s
Push docs to Crowdin / Push documentation to Crowdin (push) Failing after 55s
Push translations to Crowdin / Extract and upload translations (push) Failing after 5s
Push website translations to Crowdin / Extract and upload website translations (push) Failing after 5s
CI Create App / create-app-test (test) (push) Has been skipped
CI Create App / create-app-test (typecheck) (push) Has been skipped
CI Docs / docs-lint (push) Has been skipped
CI Example App Hello World / example-app-hello-world (push) Has been skipped
CI Front / front-task (lingui:extract) (push) Has been skipped
CI Front / front-task (test) (push) Has been skipped
CI Front / front-task (typecheck) (push) Has been skipped
CI UI / ui-sb-build (push) Failing after 1m32s
CI Twenty Apps / ${{ matrix.app.name }} (${{ matrix.server-source }}) (push) Has been skipped
CI Agent Skills / agent-skills-publish (push) Has been skipped
CI Create App / ci-create-app-status-check (push) Successful in 2s
CI Agent Skills / agent-skills-remote-source (push) Has been skipped
CI Create App E2E minimal / create-app-e2e-minimal (push) Has been cancelled
CI E2E Main / e2e-test (push) Has been cancelled
CI Front / front-sb-build (push) Has been cancelled
CI Front / front-build (push) Has been cancelled
CI Create App E2E minimal / ci-create-app-e2e-minimal-status-check (push) Has been cancelled
CI E2E Main / ci-e2e-main-status-check (push) Has been cancelled
CI E2E Main / notify-main-ci-failure (push) Has been cancelled
CI E2E Main / qa-scout-comment (push) Has been cancelled
CI Front / front-sb-test (push) Has been cancelled
CI Front / front-sb-screenshots (push) Has been cancelled
CI Front / ci-front-status-check (push) Has been cancelled
DPA Sub-Processor Sync / sync-subprocessors (push) Failing after 3s
AI Catalog Sync / sync-catalog (push) Failing after 2s
snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)
2026-09-17 23:28:13 +05:00

75 lines
6.0 KiB
Plaintext

---
title: Créditos
description: Um saldo simples que alimenta seus fluxos de trabalho, agentes de IA e chat de IA — quanto vale um crédito, até onde ele vai e como gerenciá-lo.
---
## O que são créditos?
Créditos são um saldo único que alimenta tudo o que executamos em seu nome e que tem um custo real: **automações de fluxos de trabalho**, **agentes de IA** e o **chat de IA**. Em vez de gerenciar cotas separadas para "execuções de automação" e "tokens de IA", você tem um saldo simples para acompanhar.
**1 crédito = US$ 1 de uso.** Um crédito é apenas um dólar de trabalho, então o seu saldo é fácil de entender — sem unidades abstratas para converter.
## Até onde vai um crédito?
O custo escala com o trabalho. Automações do dia a dia e mensagens de IA rápidas custam uma pequena fração de um crédito; tarefas grandes de agentes de IA com várias etapas custam mais. Aqui está uma visão aproximada:
| O que você faz | Custa aproximadamente | O que significa |
| ---------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | --------------------------------- |
| Executa uma etapa padrão de fluxo de trabalho (pesquisar, criar ou atualizar registros) ou aciona a função lógica de um aplicativo | $0.0001 | **10.000 execuções por crédito** |
| Chamar uma API externa ou executar um nó de código | Uma pequena fração de um crédito | Milhares por crédito |
| Enviar uma mensagem de chat de IA rápida ou uma etapa simples de IA | Uma fração de centavo | Centenas por crédito |
| Executar uma grande tarefa de agente de IA (por exemplo, "configurar 10 objetos do espaço de trabalho") | Pode chegar a **~$1 ou mais** | Alguns por crédito |
| Executar uma pesquisa na web com IA | Um custo fixo por pesquisa | Centenas de pesquisas por crédito |
<Note>
Para a maioria das equipes, as automações padrão são praticamente gratuitas — você só vai notar um impacto no seu saldo quando depender de recursos de IA ou executar nós de código pesados. Isso é intencional: os créditos incluídos são pensados para permitir que você crie sem ficar de olho no medidor.
</Note>
<Note>
Nem todo app cobra por suas execuções. O Gravador de Chamadas e o último contato reagem a todos os e-mails e eventos do calendário importados para a sua área de trabalho, para que suas funções lógicas sejam gratuitas. Você ainda será cobrado pelo trabalho medido que eles realizam, como minutos de chamadas gravadas.
</Note>
## Como o uso de IA é medido
Quando uma ação chama um modelo de IA, medimos exatamente os tokens usados e os cobramos pelas **tarifas publicadas pelo provedor do modelo**, depois convertemos esse valor em dólares diretamente em créditos — assim, o que você gasta acompanha o custo real do trabalho, não uma taxa interna com acréscimo. Uma mensagem de chat curta custa uma fração de centavo. Uma tarefa grande de agente — configurando 10 objetos do espaço de trabalho — faz muitos modelos chamar num contexto crescente, para que possa somar até um dólar ou mais. Você é cobrado apenas pelo que realmente usa, até o nível de token.
O custo varia de acordo com o modelo: um modelo leve é dramaticamente mais barato por mensagem do que um modelo de raciocínio de nível superior. Você pode ver o detalhamento por ação — incluindo qual modelo foi usado — em **Configurações → Cobrança**.
## O que está incluído
Toda assinatura inclui créditos, e o valor depende do seu **ciclo de cobrança**, não do seu plano:
| Ciclo de cobrança | Créditos incluídos | Uso equivalente |
| ----------------- | ------------------ | ------------------- |
| Mensal | 5 / mês | ~$5 de uso por mês |
| Anual | 50 / ano | ~$50 de uso por ano |
Esses créditos são projetados para cobrir confortavelmente as automações do dia a dia. Cinco créditos cobrem dezenas de milhares de etapas padrão de automação ou centenas de rápidas mensagens de IA - embora um punhado de grandes, tarefas de agentes de várias etapas podem usá-las mais rápido. Você pode recarregar a qualquer momento (veja abaixo).
## Acúmulo de créditos
Créditos não utilizados são automaticamente acumulados para o próximo período de cobrança.
* **Caps**: A Rollover é limitada à alocação total de uma menstruação, então você nunca vai transferir mais do que o seu ciclo de faturação fornece por menstruação.
* **Visibilidade**: Quando houver créditos acumulados, eles aparecerão como uma linha separada chamada **Créditos acumulados** em **Configurações → Cobrança**, juntamente com o saldo de **Total disponível**.
## Monitoramento de uso
Acompanhe o seu saldo e para onde ele está indo:
1. Vá para **Configurações → Cobrança**
2. Veja seus **créditos restantes** e o **uso no período atual**
3. Aprofunde-se no detalhamento para ver quais fluxos de trabalho e ações de IA estão consumindo créditos — e quais modelos as ações de IA usaram
Revisar isso regularmente torna fácil identificar cedo um fluxo de trabalho pesado e decidir se deseja otimizá-lo ou recarregar.
## Precisa de mais créditos?
Se você ficar sem créditos — ou quiser uma folga antes de uma grande onda de automação — pode comprar pacotes de créditos adicionais a qualquer momento:
1. Vá para **Configurações → Cobrança**
2. Clique no botão **Aumentar**
3. Selecione a quantidade que você precisa e aceite as alterações
Os créditos comprados são adicionados imediatamente ao seu saldo disponível.