Sanity logosanity.ioAll Systems Operational© Sanity 2026
Change Site Theme
Sanity logo

Documentation

    • Overview
    • Platform introduction
    • Next.js quickstart
    • Nuxt.js quickstart
    • Astro quickstart
    • React Router quickstart
    • Studio quickstart
    • Build with AI
    • Content Lake
    • Functions
    • APIs and SDKs
    • Visual Editing
    • Blueprints
    • Platform management
    • Dashboard
    • Studio
    • Canvas
    • Media Library
    • App SDK
    • Content Agent
    • HTTP API
    • CLI
    • Libraries
    • Specifications
    • Changelog
    • User guides
    • Developer guides
    • Courses and certifications
    • Join the community
    • Templates
Platform management
Overview

  • Plans and billing

    Platform terminology
    Plans and payments
    Projects, organizations, and billing
    Pricing
    Understanding the Growth plan trial
    Extending the Growth plan with paid add-ons
    Sanity's non-profit plan
    How AI Credits work

  • Auditing

    Activity Feed
    Request logs
    Request tags
    Request logs data reference

On this page

Previous

Sanity's non-profit plan

Next

Activity Feed

Was this page helpful?

On this page

  • Credit pricing
  • Example costs
  • Controlling costs
  • Control usage
  • Tips for efficient usage
Platform managementLast updated January 29, 2026

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:

PromptCalculationCredits
"Show Q3 blog posts"1 query + 1 action6 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.

An AI usage dashboard showing 6,826 total credits used, broken down by Agent Actions, Content Agent Queries, and Content Agent Actions, with a bar chart visualizing daily usage trends over 8 days.

The usage overview also shows which individuals in your organization are the most prolific users of AI features.

Loading...

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.

Loading...

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.

Dashboard detailing AI usage by user, featuring a table of total usage and a stacked bar chart of daily usage over time.
AI usage dashboard showing $100 remaining and a $100 spending cap.