{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["availability","callout","faq","faq-item","partial"]},"redocly_category":"AI","type":"markdown","userRole":"Users, Editors, and Admins","accountType":"All accounts","plan":"All subscription plans"},"seo":{"title":"Understanding AI credits","description":"Learn how Databox AI credits power Genie and MCP, what drives usage, and how to add more credits when you need them.","siteUrl":"https://help.databox.com","llmstxt":{"title":"Databox Knowledge Base","description":"Databox is a business analytics platform that consolidates data in one place, enabling real-time performance tracking and insights by mixing and matching data from various sources for a comprehensive view.","details":{"content":"This knowledge base covers everything from account setup and integrations to building Databoards, creating custom metrics, and using AI-powered features."},"sections":[{"title":"General","includeFiles":["docs/general/*.md","docs/general/visualization-types/*.md","docs/general/templates/*.md"]},{"title":"AI","includeFiles":["docs/ai/*.md"]},{"title":"Account Management","includeFiles":["docs/account-management/**/*.md"]},{"title":"Databoards","includeFiles":["docs/databoards/**/*.md"]},{"title":"Data Management","includeFiles":["docs/data-management/**/*.md"]},{"title":"Metrics","includeFiles":["docs/metrics/**/*.md"]},{"title":"Goals","includeFiles":["docs/goals/*.md"]},{"title":"Reports","includeFiles":["docs/reports/*.md"]},{"title":"Notifications","includeFiles":["docs/notifications/*.md"]},{"title":"Pricing and Billing","includeFiles":["docs/pricing-and-billing/*.md"]},{"title":"Mobile","includeFiles":["docs/mobile/*.md"]},{"title":"Support","includeFiles":["docs/support/*.md"]},{"title":"Company","includeFiles":["docs/company/*.md"]},{"title":"Integrations","includeFiles":["docs/integrations/**/*.md"]}]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"understanding-ai-credits","__idx":0},"children":["Understanding AI credits"]},{"$$mdtype":"Tag","name":"Availability","attributes":{"users":"users","accounts":"all","plans":"all"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Databox's AI features, including Genie, routines, skills, and the MCP server, rely on AI models to interpret your data, generate insights, and take action on your behalf, and the compute behind those requests varies with how complex each one is. Databox measures that usage with AI credits, so every account gets predictable access to its AI features without unexpectedly running out mid-month."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Callout","attributes":{"type":"note"},"children":["Genie's early access phase, which offered free usage with daily limits, has ended. AI credits now govern usage for every AI feature, across all accounts."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"credit-usage-and-consumption","__idx":1},"children":["Credit usage and consumption"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Credits represent the amount of AI processing required to complete a request — simpler tasks use fewer credits, while more complex requests use more. Actions like generating insights, building artifacts or Databoards, and asking questions about your data all draw from a single monthly credit pool."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Credits are shared across the account"]}," — all users draw from the same pool, so usage by one person affects what's available to the rest of the team."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Unused credits do not roll over"]}," — any credits remaining at the end of a billing cycle expire and are not carried into the next one."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Credit usage is always visible"]}," — the number of credits used for each response or action is shown, so you can track consumption as you go."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Responses always finish"]}," — if credits run out mid-response, Genie completes the current message before stopping."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The table below shows typical credit consumption by action. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Avg"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["median"]}," reflect the most common usage per action. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Typical span"]}," covers the middle 50% of requests (P25–P75), and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["wider span"]}," reflects nearly the full range (P10–P98), including unusually large or small requests."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"class":"table-header","className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Operation"},"children":["Operation"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Avg (trimmed)"},"children":["Avg (trimmed)"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Median"},"children":["Median"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Typical span"},"children":["Typical span"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Wider span"},"children":["Wider span"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tier"},"children":["Tier"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Help / Search"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1.3 cr"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1.2 cr"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0.8–2.0 cr"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0.6–3.3 cr"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Very low"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Metric visualization"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2.6 cr"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2.5 cr"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1.8–3.4 cr"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1.5–5.3 cr"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Low"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Data analysis · light"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["4.1 cr"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3.1 cr"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1.9–4.9 cr"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1.3–8.5 cr"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Medium"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create custom metric"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["4.6 cr"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3.4 cr"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2.5–7.6 cr"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1.8–12.4 cr"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Medium"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Data analysis · deep"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["12.6 cr"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["11.4 cr"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["7.3–14.6 cr"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["4.7–18.4 cr"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["High"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create Databoard"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["10.7 cr"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["10.6 cr"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["7.0–15.8 cr"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["4.5–27.0 cr"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["High"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Callout","attributes":{"type":"note"},"children":["Actual usage for a specific request depends on the size of your data and the length of the AI-generated response, so your results may fall outside these ranges."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"included-credits-and-reset-schedule","__idx":2},"children":["Included credits and reset schedule"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every account receives a set number of credits based on its subscription plan. Agency accounts share one credit pool across the parent account and all managed clients, so usage from any client space draws from the same allowance."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This amount resets automatically on the account's billing anchor date each month. Admins can purchase additional credits as a monthly top-up when an account is nearing its limit. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/top-up-your-ai-credits"},"children":["Top up your AI credits"]}," for setup steps."]},{"$$mdtype":"Tag","name":"Faq","attributes":{},"children":[{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"Do AI Summary visualizations use AI credits?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["No. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/understanding-the-ai-summary-visualization"},"children":["AI Summary visualizations"]}," don't use AI credits, whether they update automatically or you refresh them manually."]}]},{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"What is a billing anchor date?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The billing anchor date is the recurring monthly date tied to your subscription's billing cycle. Both the included credit allowance and any active top-up renew on this date."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[" "]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":4,"cardMinWidth":160},"children":[{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Ask Genie","icon":"genie","to":"https://app.databox.com/genie","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Get instant answers or help with your data using the in-app AI assistant."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Talk to an expert","icon":"assistance","to":"https://meetings.hubspot.com/databox-meeting/account-management","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For customers: Get help with your setup, strategy, or making the most of Databox."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Book a demo","icon":"eye-open","to":"https://meetings.hubspot.com/databox-meeting/ref-knowledge-base","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["New to Databox? See how it works and get guidance on getting started."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Send an email","icon":"help","to":"mailto:help@databox.com","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reach out to support for help with your account, data, or technical issues."]}]}]}]},"headings":[{"value":"Understanding AI credits","id":"understanding-ai-credits","depth":1},{"value":"Credit usage and consumption","id":"credit-usage-and-consumption","depth":2},{"value":"Included credits and reset schedule","id":"included-credits-and-reset-schedule","depth":2}],"frontmatter":{"slug":"understanding-ai-credits","seo":{"title":"Understanding AI credits","description":"Learn how Databox AI credits power Genie and MCP, what drives usage, and how to add more credits when you need them."},"keywords":{"includes":["AI credits","Databox AI credits","Genie credits","MCP credits","buy AI credits","additional AI credits","AI credit top-up","AI credit pool","billing anchor date","AI credit reset"]},"metadata":{"userRole":"Users, Editors, and Admins","accountType":"All accounts","plan":"All subscription plans"}},"lastModified":"2026-09-07T17:09:24.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/understanding-ai-credits","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}