Browse documentation

🧭 Start Here

Blackcap Overview ✨ Blackcap Feature Catalog 🤖 AI Features 🧱 Technology, Administration, and Reliability Installation First Run

📘 User Guides

Administration and Operations Platform Configuration Organization Configuration Email and Consent Management

🚀 Deploy Blackcap

Platform Stacks and Raspberry Pi Hardware Raspberry Pi Deployment Raspberry Pi Client Services GCP Deployment Packaged Blackcap deployment Application Updates After Your First Blackcap Login: Self-Hosted Setup Guide Blackcap Release Notes Environment Variables and Secrets Reverse Proxy and TLS Background Jobs and Schedules

🛠️ Administer Blackcap

Organizations Users, Permissions, and Authentication Configuration Workspace Backups and Restore Database Administration Regression Testing Performance and Job Status Audit, Access Activity, and Logging GeoIP and Access Location Data Retention and Purge Support Chat Administration Support Requests API Tester and Postman Instance Reporting Third-Party Packages and Attribution AI Provider Usage and Billing Portals Microwave Pie licensing for Blackcap Microwave Pie licensing for Blackcap

🍽️ Use Recipes

Recipes and the Recipe Library Recipe Import and Discovery Recipe Editing and Cache Artifacts Recipe Sharing Social Recipe Import AI Recipe Image Generation 🪄 Adapt Recipe and 🎲 Variations

📅 Plan Meals

Meal Planner

🛒 Use Shopping Lists

Shopping Lists and Shop a List External and Household Shopping 🔗 Chrome Extension Shop With

🧺 Manage Kitchen Inventory

🧺 Kitchen Inventory

🖥️ Use Displays

Displays and Connections Assigning and Scheduling Display Content Remote Pi Client E-Ink Rendering Menu Refresh and Rendering Noun Project Footer Images

🧑‍🍳 Cook with Let’s Cook

🧑‍🍳 Let’s Cook 🧑‍🍳 Let’s Cook Controls and Timers

🤖 Use and Administer AI

🤖 AI in Blackcap 🤖 AI Providers and Connections 🤖 AI Seeds and Usage Support Chat

🔗 Use the Chrome Extension

🔗 Blackcap Chrome Extension 🔗 Chrome Extension Recipe Capture 🔗 Chrome Extension Shop With 🔗 Chrome Extension Release and Privacy

🎮 Play Games

Games and trivia Bramble Harvest — Player Guide Flavor Lab — Player Guide

🔌 Integrations

Email Integration Cloud Storage Integrations Voice Assistants Shop With Integrations Authentication Providers

⚙️ Develop Blackcap

Application Architecture Database Service and Data Access SQLite and PostgreSQL Database Migrations Background Job Architecture Testing Games platform — current developer reference Bramble Harvest developer tools API Architecture Security and Organization Scoping UI, Icons, and Documentation Assets Blackcap-Safe Emoji Support Chat Architecture Extending Support Chat Support Chat Model Benchmark Documentation Standards Terminology

⚠️ Troubleshoot Blackcap

⚠️ Troubleshooting Licensing Troubleshooting Deployment Troubleshooting Display Troubleshooting Recipe Import Troubleshooting 🤖 AI Troubleshooting Backup Troubleshooting Database Troubleshooting Diagnostic Organization Clones Support Chat

AI Provider Usage and Billing Portals

Access: Configuration → Platform → AI → Provider Connections (authorized AI administrators).

Each OpenAI, Google Gemini, and Anthropic Claude provider connection provides an external usage and billing link in the provider row and in the Edit Provider dialog. The link opens the provider's own portal in a separate browser tab; it never passes Blackcap API keys to that site.

Provider Billing/usage portal What to check there
OpenAI OpenAI Platform Organization usage, costs, payments and prepaid credits where applicable
Anthropic Claude Claude Platform Workspace/organization usage, cost and credit information according to plan
Google Gemini Google AI Studio API usage and linked billing account details

No balance is saved or calculated in Blackcap. There is no manual balance editor, provider balance column, or locally inferred remaining-credit amount. A spend figure is not equivalent to cash or prepaid credit remaining; some accounts are postpaid, and a provider billing account can cover more than one API key or connection.

Possibility of automated remaining-credit display

  • OpenAI organization Usage and Costs endpoints can provide historical spend with separate admin privileges, but should not be treated as an authoritative account-credit balance.
  • Anthropic organization Usage/Cost reporting likewise is not guaranteed to provide remaining account credit; available APIs and permissions depend on account type.
  • Gemini billing varies by AI Studio or linked Google Cloud billing account. Ordinary inference credentials should not be assumed to authorize an account-balance request.

If a provider later offers a documented, authenticated, read-only remaining-balance endpoint, an optional System Admin-only integration can show a labeled balance, retrieval timestamp and errors. Do not use manual-entry or a spending-derived estimate as a substitute for provider-reported funds.

On this page