diff --git a/packages/twenty-docs/user-guide/billing/capabilities/credits.mdx b/packages/twenty-docs/user-guide/billing/capabilities/credits.mdx index b644140d75..7c0f0ec5a0 100644 --- a/packages/twenty-docs/user-guide/billing/capabilities/credits.mdx +++ b/packages/twenty-docs/user-guide/billing/capabilities/credits.mdx @@ -15,17 +15,20 @@ Cost scales with the work. Everyday automation and quick AI messages cost a tiny | What you do | Roughly costs | What that means | |-------------|---------------|-----------------| -| Run a standard workflow step (search, create, update records) | ~$0.0001 | About **10,000 steps per credit** | +| Run a standard workflow step (search, create, update records) or trigger an app's logic function | $0.0001 | **10,000 runs per credit** | | Call an external API or run a code node | A small fraction of a credit | Thousands per credit | | Send a quick AI chat message or simple AI step | A fraction of a cent | Hundreds per credit | | Run a large AI agent task (e.g. "configure 10 workspace objects") | Can run to **~$1 or more** | A few per credit | | Run an AI web search | A fixed per-search cost | Hundreds of searches per credit | -| Trigger app's logic function | A small fraction of a credit | Thousands per credit | For most teams, standard automations are effectively free — you'll only make a noticeable dent in your balance when you lean on AI features or run heavy code nodes. That's by design: the included credits are meant to let you build without watching a meter. + +Not every app charges for its runs. Call Recorder and Last contact react to every email and calendar event imported into your workspace, so their logic function runs are free. You are still charged for the metered work they do, such as recorded call minutes. + + ## How AI usage is metered When an action calls an AI model, we measure the exact tokens used and price them at **the model provider's published rates**, then convert that dollar amount straight into credits — so what you spend tracks the real cost of the work, not a marked-up internal rate. A short chat message costs a fraction of a cent. A large agent task — say, configuring ten workspace objects — makes many model calls over a growing context, so it can add up to a dollar or more. You're billed for what you actually use, down to the token.