Skip to content

Commit 455e29c

Browse files
SBrandeisPierrci
andauthored
[ZeroGPU] Update the documentation (#2348)
* ZeroGPU: update the documentation * Update docs/hub/spaces-zerogpu.md Co-authored-by: Pierric Cistac <Pierrci@users.noreply.github.com> --------- Co-authored-by: Pierric Cistac <Pierrci@users.noreply.github.com>
1 parent 9d6ebfb commit 455e29c

5 files changed

Lines changed: 26 additions & 17 deletions

File tree

docs/hub/billing.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ The PRO subscription unlocks essential features for serious users, including:
2828
- Higher [storage capacity](./storage-limits) for public and private repositories
2929
- Higher bandwidth and API [rate limits](./rate-limits)
3030
- Included credits for [Inference Providers](/docs/inference-providers/)
31-
- Higher tier for ZeroGPU Spaces usage
31+
- Higher tier for ZeroGPU Spaces usage, and pay-as-you-go quota extension
3232
- Ability to create ZeroGPU Spaces and use Dev Mode
3333
- Ability to publish Social Posts and Community Blogs
3434
- Leverage the [Data Studio](./data-studio) on private datasets

docs/hub/enterprise.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -39,21 +39,21 @@ Team & Enterprise organization plans add advanced capabilities to organizations,
3939
| Scale deployment with Inference Endpoints | ✅ PAYG | ✅ PAYG | ✅ PAYG | ✅ PAYG |
4040
| Hub credits\* included in plan || ❌ (bulk purchase available) | $2k included | 5% of ACV included |
4141

42-
\* Hub credits can be utilized for inference providers, inference endpoints, Jobs, Space upgrade
42+
\* Hub credits can be utilized for inference providers, inference endpoints, Jobs, Space upgrade, ZeroGPU quota extension
4343

4444
### Spaces & Jobs
4545

4646
| Feature | Free | Team | Enterprise | Enterprise Plus |
4747
| -------------------------------------- | --------- | ----------- | ----------- | --------------- |
4848
| Spaces – CPU-based runtime | 8 units\* | ✅ No limit | ✅ No limit | ✅ No limit |
49-
| Spaces – ZeroGPU usage tiers | 3.5 min† | 25 min | 45 min | 45 min |
49+
| Spaces – ZeroGPU usage tiers | 3.5 min† | 25 min | 45 min | 45 min |
5050
| Spaces – Upgraded hardware | PAYG | PAYG | PAYG | PAYG |
5151
| Dev Mode / Custom domain for Spaces |||||
5252
| Jobs & Scripts (train/fine-tune, eval) | PAYG | PAYG | PAYG | PAYG |
5353

5454
\* running at the same time
5555

56-
† daily quota
56+
included daily quota; paid plans can extend beyond quota using credits at $1 per 10 min of GPU time
5757

5858
### Repo rules, access control, visibility
5959

docs/hub/pro.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ The PRO subscription unlocks essential features for serious users, including:
55
- Higher [storage capacity](./storage-limits) for public and private repositories
66
- Higher bandwidth and API [rate limits](./rate-limits)
77
- Included credits for [Inference Providers](/docs/inference-providers/)
8-
- Higher tier for [ZeroGPU Spaces](./spaces-zerogpu) usage
8+
- Higher tier for [ZeroGPU Spaces](./spaces-zerogpu) usage, and pay-as-you-go quota extension
99
- Ability to create ZeroGPU Spaces and use [Dev Mode](./spaces-dev-mode)
1010
- Ability to publish Social Posts and Community Blogs
1111
- Leverage the [Data Studio](./data-studio) on private datasets

docs/hub/spaces-api-endpoints.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -225,16 +225,18 @@ The `Authorization` header is required for private Spaces and gives better rate
225225

226226
ZeroGPU Spaces have usage quotas based on your account type:
227227

228-
| Account Type | Daily GPU Quota |
229-
|-------------|----------------|
228+
| Account Type | Included Daily GPU Quota |
229+
|-------------|--------------------------|
230230
| Unauthenticated | 2 minutes |
231231
| Free account | 3.5 minutes |
232232
| PRO account | 25 minutes |
233233

234234
When you authenticate with your token, your account's GPU quota is consumed. Unauthenticated requests use a shared pool with stricter limits.
235235

236+
PRO, Team, and Enterprise users can go beyond their included daily quota using pre-paid credits at the rate of **$1 per 10 minutes** of GPU time.
237+
236238
> [!TIP]
237-
> You can [subscribe to PRO](https://huggingface.co/subscribe/pro) for 25 minutes of daily GPU quota and higher queue priority.
239+
> You can [subscribe to PRO](https://huggingface.co/subscribe/pro) for 25 minutes of daily GPU quota, higher queue priority, and the ability to extend your quota with credits.
238240
239241
## Common patterns
240242

docs/hub/spaces-zerogpu.md

Lines changed: 16 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ Unlike traditional single-GPU allocations, ZeroGPU's efficient system lowers bar
1313

1414
- **Using existing ZeroGPU Spaces**
1515
- ZeroGPU Spaces are available to use for free to all users. (Visit [the curated list](https://huggingface.co/spaces/enzostvs/zero-gpu-spaces)).
16-
- [PRO users](https://huggingface.co/subscribe/pro) get x7 more daily usage quota and highest priority in GPU queues when using any ZeroGPU Spaces.
16+
- [PRO users](https://huggingface.co/subscribe/pro) get x7 more daily usage quota, highest priority in GPU queues, and can go beyond their daily quota using pre-paid credits when using any ZeroGPU Spaces.
1717
- **Hosting your own ZeroGPU Spaces**
1818
- Personal accounts: [Subscribe to PRO](https://huggingface.co/settings/billing/subscription) to access ZeroGPU in the hardware options when creating a new Gradio SDK Space.
1919
- Organizations: [Subscribe to a Team or Enterprise plan](https://huggingface.co/enterprise) to enable ZeroGPU Spaces for all organization members.
@@ -150,19 +150,26 @@ Check out this [blogpost](https://huggingface.co/blog/zerogpu-aoti) for a comple
150150

151151
GPU usage is subject to **daily** quotas, per account tier:
152152

153-
| Account type | Daily GPU quota | Queue priority |
154-
| ------------------------------ | ---------------- | --------------- |
155-
| Unauthenticated | 2 minutes | Low |
156-
| Free account | 3.5 minutes | Medium |
157-
| PRO account | 25 minutes | Highest |
158-
| Team organization member | 25 minutes | Highest |
159-
| Enterprise organization member | 45 minutes | Highest |
153+
| Account type | Included daily GPU quota | Queue priority |
154+
| ------------------------------ | ------------------------ | --------------- |
155+
| Unauthenticated | 2 minutes | Low |
156+
| Free account | 3.5 minutes | Medium |
157+
| PRO account | 25 minutes (extensible) | Highest |
158+
| Team organization member | 25 minutes (extensible) | Highest |
159+
| Enterprise organization member | 45 minutes (extensible) | Highest |
160160

161-
Quota resets exactly 24 hours after your first GPU usage.
161+
Included daily quota resets exactly 24 hours after your first GPU usage.
162162

163163
> [!NOTE]
164164
> Remaining quota directly impacts priority in ZeroGPU queues.
165165
166+
### Extending quota with credits
167+
168+
PRO, Team, and Enterprise users can continue using ZeroGPU Spaces beyond their included daily quota by consuming pre-paid credits at the rate of **$1 per 10 minutes** of GPU time.
169+
Once your daily quota is exhausted, any additional GPU usage is automatically billed against your credit balance.
170+
171+
You can add credits from your [billing settings](https://huggingface.co/settings/billing).
172+
166173
## Hosting Limitations
167174

168175
- **Personal accounts ([PRO subscribers](https://huggingface.co/subscribe/pro))**: Maximum of 10 ZeroGPU Spaces.

0 commit comments

Comments
 (0)