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/generations.md, and every docs URL returns Markdown when requested with Accept: text/markdown.

Generations: status, stages and results

A generation is one restore of a project's recording with one model (diffio-flash or diffio-pro); a project can have many.It reports status and, while it runs, stage, stage_progress and queue. When complete, GET …/media hands out its files.

How it works

  1. queued: waits for the project to be ready (stage: "pending")
  2. processing: stage: preparing, transcribing, queued, starting, downloading, decoding, restoring, finalizing, uploading
  3. complete: media, transcript and separated tracks; generation.completed
  • from processing: failed, error.code; generation.failed
Generation status. transcription_status and stems_status can still be preparing just after complete.

Webhooksgeneration.completed, generation.failed (Webhooks)

Limits

LimitValue
Billingwhole seconds, 60 second minimum per restore
Media URLs6 hours (expires_at); ask again for new ones
preview_seconds4 to 3600, rounded up to whole 4 second segments
labelup to 120 characters
SDK waitpolls every 2 seconds, gives up after 3600 seconds by default
List pagelimit 1 to 100, default 20, newest first

Build with it

Report an issue with this page