How AI Credits work
Understand how AI credits are consumed and billed for Sanity AI tooling.
Whether working with Content Agent or Agent Actions, Sanity AI tooling is measured and billed using AI Credits. This article examines what AI Credits are and how they work.
Free credits every month!
Every organization receives 100 free AI credits per month! Enough to explore these features without commitment.
Credit pricing
Each AI credit costs $0.05. Credit consumption depends on the type and scope of interaction.
- Query (your message to Content Agent): 4 credits ($0.20)
- Action (tool use by Content Agent): 2 credits ($0.10)
Queries are messages you send to the Content Agent. Each request includes a 4-credit query cost.
Actions are operations the agent performs on your behalf: GROQ queries, web searches, document analysis, content creation, and image generation. Each tool execution costs 2 credits.
A single request may involve multiple tool executions depending on the complexity of the task. The number of executions depends on the amount and type of work required - it is not a fixed number per document.
Example cost estimates
Costs vary based on document size, structure, and workflow complexity. The examples below are directional estimates and rounded up.
AI Credits cost examples
| Prompt | Estimated calculation | Estimated credits |
|---|---|---|
| "Show Q3 blog posts" | 1 query (4) + small read (2) | ~6 credits |
| "Analyze 10 articles (~1 MB total)" | 1 query (4) + analysis (~2 credits per 100 KB) | ~24 credits |
| "Update 5 documents" | 1 query (4) + mutation (~6 credits per document) | ~34 credits |
| "Translate 3 documents into 2 languages" | 1 query (4) + translation (~12 credits per document per language) | ~76 credits |
For large bulk operations, the agent may request confirmation before proceeding if estimated usage is high. If your organization reaches its spending limit, AI operations pause until the next billing cycle or until the limit is increased.
Controlling costs
Content Agent can easily operate on a large number of documents which can incur unexpected billing if used indiscriminately. To shield your organization from unintended costs you can set spending limits that will halt all AI operations once reached.
Control usage
You can find detailed overviews of your AI usage by visiting sanity.io/manage and clicking the Usage tab in the top level navigation.
The usage overview also shows which individuals in your organization are the most prolific users of AI features.
Set spending limits for AI
You can set a monthly spending limit to prevent unexpected charges. When your organization reaches the cap, AI features pause until the next billing cycle or until you raise the limit. If an operation is started while credits are still available, it will run to completion even if it exceeds the remaining budget. Visit sanity.io/manage and navigate to Settings to set or change your spending limits.
Tips for efficient usage
When working with large document sets, select a few documents first to refine your prompt before applying it to the entire set. This helps you optimize your queries and reduce unnecessary credit consumption.
