{"rid":"storage/google-gemini-files-api","card":{"rid":"storage/google-gemini-files-api","eid":"google-2","topic":"storage","slug":"google-gemini-files-api","provider":"Google Gemini Files API (AI Studio)","url":"https://ai.google.dev/gemini-api/docs/files","domain":"google.dev","category":"LLM provider /v1/files","tier":null,"verdict":"fails-quota","vorder":6,"grp":"rejected","confidence":"reported","binding":"per-object-cap","identity_kind":"email","identity_basis":"stated","needs_card":0,"needs_phone":0,"needs_id":0,"needs_institution":0,"country":null,"crypto":null,"interfaces":"rest","egress_metered":0,"per_object_bytes":2000000000,"retention_days":2,"verified_at":"2026-10-21T00:00:00.000Z","verified_basis":"inherited","checked_on":"2026-10-21","stale_on":"2026-11-04","n_evidence":4,"usd_month":null,"usd_per_tb_month":null,"summary":"20 GB per project; 2 GB per file; 48-hour retention","duplicate_of":null,"n_unknown":4},"record":{"topic":"storage","slug":"google-gemini-files-api","provider":"Google Gemini Files API (AI Studio)","url":"https://ai.google.dev/gemini-api/docs/files","category":"LLM provider /v1/files","free_tier":{"stated":"20 GB per project; 2 GB per file; 48-hour retention","unit":"GB","metered_on":"unstated","source_url":"https://ai.google.dev/gemini-api/docs/files","read_on":"2026-10-21","notes":null},"per_object_cap":{"stated":"2 GB per file","bytes":2000000000,"source_url":"https://ai.google.dev/gemini-api/docs/files","notes":"not stated"},"retention":{"stated":"20 GB per project; 2 GB per file; 48-hour retention","days":2,"source_url":"https://ai.google.dev/gemini-api/docs/files","notes":"not stated"},"egress":{"terms":"Free — 'The Files API is available at no cost in all regions where the Gemini API is available.'","metered":false},"interface":["rest"],"interface_detail":"REST via google-genai SDK `client.files.upload`; generativelanguage.googleapis.com/v1beta","tooling":"pip install google-genai; curl multipart to /upload/v1beta/files","chaining":"20 GB/project, and Google Cloud projects are the multiplicative axis. But 48-hour retention means capacity, not storage.","limits":[{"kind":"per-object-cap","value":"2 GB per file","source":"https://ai.google.dev/gemini-api/docs/files"},{"kind":"retention-clamped","value":"Retention-clamped hard at 48 hours","source":"https://ai.google.dev/gemini-api/docs/files"}],"limits_note":"per-object-cap 2 GB. Retention-clamped hard at 48 hours — you cannot request longer. PDFs additionally capped at 50 MB / 1,000 pages for processing. Inline path is 100 MB total request.","identity_cost":{"kind":"email","detail":"email","country":null},"reliability_note":"Double fail, and the docs say it in one sentence: 'Files are stored for 48 hours. During that time, you can use the API to get metadata about the files. However, **you can't download user-uploaded files**.' This is the brief's `retention-clamped` class plus a read gate. Only model-generated files (video) are downloadable.","confidence":"reported","confidence_note":"One page read moves it to documented.","evidence":[{"url":"https://ai.google.dev/gemini-api/docs/files","date":"2026-10-21","proved":"'The Files API lets you store up to 20 GB of files per project, with a per-file maximum size of 2 GB. Files are stored for 48 hours.'; 'you can't download user-uploaded files'"},{"url":"https://ai.google.dev/gemini-api/docs/files","date":"2026-10-21","proved":"'Files are automatically deleted after 48 hours'"},{"url":"https://github.com/google-gemini/cookbook/blob/main/quickstarts/File_API.ipynb","date":"2026-10-21","proved":"'The File API accepts files under 2GB in size and can store up to 20GB of files per project. Files last for 2 days and cannot be downloaded from the API.'"},{"url":"https://discuss.ai.google.dev/t/uploaded-files-missing-after-a-few-days/50428","date":"2026-10-21","proved":"'The Files API storage has an expiration time of 48 hrs and is restricted to 20GB total storage'"}],"verdict":"fails-quota","verified_at":"2026-10-21T00:00:00.000Z","notes":"20 GB per project; 2 GB per file; 48-hour retention","extras":{"dead_end":{"failure_class":"retention","why":"20 GB per project; 2 GB per file; 48-hour retention","retry_when":null,"first_recorded":"2026-10-21"}},"binding":"per-object-cap","binding_note":"the per-object cap sets the shard size and therefore the object count; it bounds the total more tightly than any headline quota"},"claims":[{"path":"$.free_tier.stated","kind":"free-quota","num":20,"unit":"GB","per":null,"currency":null,"usd":null,"fx_date":null,"parse":"ok"},{"path":"$.limits[0].value","kind":"limit:per-object-cap","num":2,"unit":"GB","per":null,"currency":null,"usd":null,"fx_date":null,"parse":"ok"},{"path":"$.limits[1].value","kind":"limit:retention-clamped","num":48,"unit":"hours","per":null,"currency":null,"usd":null,"fx_date":null,"parse":"ok"}],"unknown":[["$.extras.dead_end.retry_when","process"],["$.free_tier.notes","process"],["$.per_object_cap.notes","not-extracted"],["$.retention.notes","not-extracted"]],"history":[],"drift":[]}