Hugging Face
Connect your Hugging Face organization to track Inference Endpoints, Spaces, Jobs, and storage costs in StackSpend.
Hugging Face
Organization billing API — fine-grained token required
The Hugging Face provider connects StackSpend to your organization’s billing data via the Hugging Face API. StackSpend tracks costs from the date of connection onward, aligned to the monthly billing cycle.
What StackSpend tracks
- Inference Endpoints compute costs
- Spaces (Gradio) usage
- Training and inference Jobs
- Inference Providers charges
- Private Storage fees
- Monthly billing cycle; data available from setup date onward
Prerequisites
- A Hugging Face organization account
- Admin or owner access to the organization
Setup
Create an access token
Go to huggingface.co → Settings → Access Tokens and click New token. Set the type to Fine-grained.
Enable the following permissions:
- User → Read access to your billing usage and subscription info
- Organizations → Read access to organizations settings
Copy the token after creation.
Add to StackSpend
In StackSpend, go to Providers → Hugging Face. Enter your access token and your organization name (the slug from your organization’s Hugging Face URL). Click Save.
Data summary
| Attribute | Value |
|---|---|
| Data latency | Monthly |
| Historical data | From setup date |
| Setup time | 3 min |
Frequently asked questions
What credential does StackSpend need to connect Hugging Face?
StackSpend needs a read-only fine-grained token plus your organization name (the slug from your organization URL). The token must have read access to your billing usage and to organization settings; a regular read token does not have billing access and will not work.
Is the connection read-only?
Yes. StackSpend only reads organization billing data through the Hugging Face API and never writes to your account. It tracks Inference Endpoints, Spaces, Jobs, Inference Providers charges, and Private Storage fees.
How long does setup take and how much history loads?
Setup takes about 3 minutes. StackSpend tracks costs from the date of connection onward, aligned to the monthly billing cycle, rather than backfilling earlier history.
Why don't I see any cost data yet?
Hugging Face billing follows a monthly cycle and data is available from the setup date onward, so costs may take time to accrue and appear. If nothing shows, confirm you used a fine-grained token with both user billing and organization settings scopes and that the organization name matches your URL slug.