Skip to content
Project
For AI agents: every API docs page in one plain-text file is at /docs/llms-full.txt, and the documentation index is at /llms.txt. This page is available as Markdown at https://diffio.ai/docs/overview/concepts/projects-and-uploads.md, and every docs URL returns Markdown when requested with Accept: text/markdown.

Projects and uploads
A project is one recording: create it, upload the file to Diffio's media host with its upload_token, then run generations on it.The upload goes in parts of part_size_bytes; the project checks the file and becomes ready.
How it works
awaiting_upload: created;uploadholds the token and requestspreparing: the file arrived and is being checkedready: generations run;project.readywebhook
- from
preparing:failed, the file could not be read;project.failedwebhook
status. A generation requested with the project waits in queued until ready.Webhooksproject.ready, project.failed (Webhooks)
Limits
| Limit | Value |
|---|---|
| File size | up to 2 GB (2,147,483,648 bytes); larger is 413 upload_too_large |
| Media length | no limit |
| Part size | 32 MiB (33554432 bytes); every part but the last |
| Upload token | 24 hours (upload.expires_at); POST …/upload gives a new one |
Ready without upload/complete | about 30 seconds after the media host has the file |
upload/complete check | up to 180 seconds inside the request |
| metadata | 50 keys; keys up to 40 characters, values up to 500 |
| Idempotency-Key | up to 255 characters, per account and end user |
| List page | limit 1 to 100, default 20, newest first |