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 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 query costs 4 credits regardless of complexity.
Actions are operations the agent performs on your behalf: GROQ queries, web searches, document analysis, content creation, and image generation. When an action involves multiple documents, each document incurs the 2-credit cost. For example, analyzing 10 articles costs 20 credits (10 × 2).
Example costs
A simple request, such as “Show me blog posts from Q3,” costs 6 credits ($0.30): 4 for your query and 2 for the GROQ search.
Requests that touch multiple documents scale accordingly:
| Prompt | Calculation | Credits |
|---|---|---|
| "Show Q3 blog posts" | 1 query + 1 action | 6 credits |
| "Analyze 10 articles for tone" | 1 query + ~12 actions | ~28 credits |
| "Create 5 pages" | 1 query + ~15 actions | ~34 credits |
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. 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.
Was this page helpful?