{"rid":"inference/huggingface-zerogpu-spaces-api","card":{"rid":"inference/huggingface-zerogpu-spaces-api","eid":"huggingface","topic":"inference","slug":"huggingface-zerogpu-spaces-api","provider":"Hugging Face ZeroGPU Spaces (public Spaces called through the Gradio client)","url":"https://huggingface.co/docs/hub/en/spaces-zerogpu","domain":"huggingface.co","category":"inference via hosted demos, GPU quota","tier":null,"verdict":"qualifies-with-caveat","vorder":1,"grp":"usable","confidence":"documented","binding":"volume-quota","identity_kind":"anonymous","identity_basis":"stated","needs_card":0,"needs_phone":0,"needs_id":0,"needs_institution":0,"country":null,"crypto":null,"interfaces":"rest","egress_metered":null,"per_object_bytes":null,"retention_days":null,"verified_at":"2026-10-28T04:36:19.143Z","verified_basis":"live","checked_on":"2026-10-29","stale_on":"2026-11-29","n_evidence":6,"usd_month":null,"usd_per_tb_month":null,"summary":"ZeroGPU Spaces are available to use for free to all users: 2 minutes of GPU a day unauthenticated and 5 minutes a day on a free account, reset exactly 24 hou...","duplicate_of":null,"n_unknown":4,"free_unit":"minutes"},"record":{"topic":"inference","slug":"huggingface-zerogpu-spaces-api","provider":"Hugging Face ZeroGPU Spaces (public Spaces called through the Gradio client)","url":"https://huggingface.co/docs/hub/en/spaces-zerogpu","category":"inference via hosted demos, GPU quota","per_object_cap":{"stated":"not applicable"},"retention":{"stated":"not applicable"},"egress":{"terms":null,"metered":false},"free_tier":{"stated":"ZeroGPU Spaces are available to use for free to all users: 2 minutes of GPU a day unauthenticated and 5 minutes a day on a free account, reset exactly 24 hours after the first GPU usage","unit":"minutes","metered_on":"wall-clock","source_url":"https://huggingface.co/docs/hub/en/spaces-zerogpu","read_on":"2026-10-28","notes":"the model served is whatever the Space's author runs; the quota counts GPU time of the function call, and the xlarge size costs twice the quota"},"interface":["rest"],"interface_detail":"the Gradio API of a public Space, called with gradio_client.Client(space_id, token=...).predict()","tooling":"gradio_client (pip install --upgrade gradio_client); huggingface_hub for the token","chaining":"the hosting side of the same GPU pool is recorded at compute/huggingface-spaces-zerogpu; duplicating a Space to a private one moves the cost to the caller's account","limits":[{"kind":"volume-quota","value":"2 minutes of GPU a day unauthenticated (queue priority Low) and 5 minutes a day on a free account (Medium); PRO is 40 minutes","source":"https://huggingface.co/docs/hub/en/spaces-zerogpu, read 2026-10-28"},{"kind":"request-rate","value":"a public Space used as an API may be rate limited by Hugging Face if too many requests are made; no number is published","source":"https://www.gradio.app/guides/getting-started-with-the-python-client, read 2026-10-28"}],"binding":"volume-quota","binding_note":"minutes of GPU a day bind long before any request count does","identity_cost":{"kind":"anonymous","detail":"the Unauthenticated tier needs no account and gets 2 minutes a day; a free Hugging Face account is the 5-minute tier. What a free account signup requires is unverified on the pages read","country":null},"reliability_note":"quota left lowers queue priority, and whether a gradio_client call made with a token is counted against that account's quota is not stated on the pages read","confidence":"documented","confidence_note":"the daily quota table is quoted from the vendor documentation; no Space was called","evidence":[{"url":"https://huggingface.co/docs/hub/en/spaces-zerogpu","date":"2026-10-28","capture":"sha256:949c22d45251350837459dc32cd16a8713d43068105dd2e610515a6e41af513b","quote":"ZeroGPU Spaces are available to use for free to all users.","proved":"ZeroGPU Spaces are free to use for all users"},{"url":"https://huggingface.co/docs/hub/en/spaces-zerogpu","date":"2026-10-28","capture":"sha256:949c22d45251350837459dc32cd16a8713d43068105dd2e610515a6e41af513b","quote":"| Unauthenticated                | 2 minutes                | Low             |","proved":"unauthenticated use gets 2 minutes of GPU a day at low queue priority"},{"url":"https://huggingface.co/docs/hub/en/spaces-zerogpu","date":"2026-10-28","capture":"sha256:949c22d45251350837459dc32cd16a8713d43068105dd2e610515a6e41af513b","quote":"| Free account                   | 5 minutes                | Medium          |","proved":"a free account gets 5 minutes of GPU a day at medium queue priority"},{"url":"https://huggingface.co/docs/hub/en/spaces-zerogpu","date":"2026-10-28","capture":"sha256:949c22d45251350837459dc32cd16a8713d43068105dd2e610515a6e41af513b","quote":"Included daily quota resets exactly 24 hours after your first GPU usage.","proved":"the daily quota resets 24 hours after the first GPU use"},{"url":"https://www.gradio.app/guides/getting-started-with-the-python-client","date":"2026-10-28","capture":"sha256:8a90d469d8566c355d893f13f1aad48eb103eca956ffcd588f05e9c923a6bf0b","quote":"While you can use any public Space as an API, you may get rate limited by Hugging Face if you make too many requests.","proved":"a public Space can be used as an API through the Gradio client and may be rate limited"},{"url":"https://www.gradio.app/guides/getting-started-with-the-python-client","date":"2026-10-28","capture":"sha256:8a90d469d8566c355d893f13f1aad48eb103eca956ffcd588f05e9c923a6bf0b","quote":"client = Client(\"abidlabs/my-private-space\", token=\"...\")","proved":"the Gradio client takes a Hugging Face token with the token parameter"}],"verdict":"qualifies-with-caveat","verified_at":"2026-10-28T04:36:19.143Z","notes":"Whether the Gradio API path draws on the same daily quota as the web page is unverified."},"claims":[{"path":"$.free_tier.stated","kind":"free-quota","num":2,"unit":"minutes","per":null,"currency":null,"usd":null,"fx_date":null,"parse":"ok"},{"path":"$.limits[0].value","kind":"limit:volume-quota","num":2,"unit":"minutes","per":null,"currency":null,"usd":null,"fx_date":null,"parse":"ok"},{"path":"$.limits[1].value","kind":"limit:request-rate","num":null,"unit":null,"per":null,"currency":null,"usd":null,"fx_date":null,"parse":"unparsed"}],"unknown":[["$.egress.metered","egress-unknown"],["$.egress.terms","process"],["$.per_object_cap.stated","not-applicable"],["$.retention.stated","not-applicable"]],"history":[],"drift":[]}