Skip to content

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

  1. awaiting_upload: created; upload holds the token and requests
  2. preparing: the file arrived and is being checked
  3. ready: generations run; project.ready webhook
  • from preparing: failed, the file could not be read; project.failed webhook
Project status. A generation requested with the project waits in queued until ready.

Webhooksproject.ready, project.failed (Webhooks)

Limits

LimitValue
File sizeup to 2 GB (2,147,483,648 bytes); larger is 413 upload_too_large
Media lengthno limit
Part size32 MiB (33554432 bytes); every part but the last
Upload token24 hours (upload.expires_at); POST …/upload gives a new one
Ready without upload/completeabout 30 seconds after the media host has the file
upload/complete checkup to 180 seconds inside the request
metadata50 keys; keys up to 40 characters, values up to 500
Idempotency-Keyup to 255 characters, per account and end user
List pagelimit 1 to 100, default 20, newest first

Build with it

Report an issue with this page