--- title: "Manage your AI credits" slug: "ai-credits" description: "Learn about AI credits in Pigment, their consumption, management, and how they enable efficient use of AI features in your Workspace." updated: 2026-09-17T08:27:19Z published: 2026-09-17T08:27:19Z canonical: "kb.pigment.com/ai-credits" stale: true --- > ## Documentation Index > Fetch the complete documentation index at: https://kb.pigment.com/llms.txt > Use this file to discover all available pages before exploring further. # Manage your AI credits This article provides more information about how credits are consumed, granted, tracked, and monitored. ### Credits included by plan The number of AI credits included in your Workspace depends on your plan. Credits are granted annually and reset at your contract anniversary date. Unused credits do **not** roll over — they expire at the end of your contract period. To change the plan you are on, speak with your Customer Success Manager. ### Credit consumption AI credit consumption reflects the amount of processing required to run AI features. For Predictions, one time series consumes 0.1 AI credits. For Agents, consumption depends on the complexity of the task performed by the Agent. As Pigment adopts state-of-the-art improvements and efficiency optimizations, the credit valuation may evolve over time. Some AI experiences may have special commercial terms (for example, limited-time free access or phased rollout). When in doubt, your [**Plan & Usage**](/v1/docs/manage-file-storage-limits#view-file-storage-usage1) and [**AI Credits**](/v1/docs/ai-credit-management) pages are the source of truth for what is currently being counted for your Workspace. For more information, see [Pigment License Types](/v1/docs/pigment-license-types#access-the-plan-usage-page). > [!NOTE] > ℹī¸ Note > > If your organization has multiple Workspaces, Workspace Admins can use the Workspaces overview to compare Workspace cells, Snapshot cells, AI credits, and file storage across Workspaces. For more information, see [View Usage Across Workspaces](/v1/docs/view-usage-across-workspaces). ### Reset schedule AI credits are tracked over a billing period tied to your subscription and contract anniversary date. At the start of a new period, your usage counter resets for the new cycle. If you purchase an add-on credit pack during the year, those additional credits are added to your Workspace and **count toward the current billing period** (they do not create a separate reset date). ### Monitor your usage Credit consumption is tracked in **near real-time**, so the figures you see in [AI credit settings](/v1/docs/ai-credit-management), [Plan & Usage](/v1/docs/pigment-license-types#access-the-plan-usage-page) and the [Workspace overview](/v1/docs/view-usage-across-workspaces) reflect your Workspace's actual usage with minimal delay. If you have Test & Deploy, consumption reflects the credits consumed from the current environment's allocation. Access to usage information is limited to **Workspace and Security Administrators**. Administrators can use this information to: - Monitor overall consumption over the current period. - Understand trends over time. - Anticipate when additional capacity may be needed. ### Reaching your credit limit Depending on your plan and configuration, Pigment may: - Notify you as you approach your limit. For more information on this notification, see [AI credits](/v1/docs/ai-credit-management#top-panel). - Limit or pause certain AI features once the Workspace reaches the credit threshold. If you anticipate higher AI usage, contact your Pigment team to discuss options. ### Older or custom pricing contracts Some customers may be on an older AI pricing model (for example, separate limits for specific AI features) or on custom terms that do not use AI credits as the contractual unit. In that case, contact your Pigment team — they can confirm which AI pricing model applies to your Workspace and share your usage details. ## Related - [Machine Learning Forecasting](/machine-learning-forecasting.md) - [Pigment AI](/pigment-ai.md) - [Manage File Storage Limits](/manage-file-storage-limits.md)