Skip to content
Generation
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
queued: waits for the project to beready(stage: "pending")processing:stage: preparing, transcribing, queued, starting, downloading, decoding, restoring, finalizing, uploadingcomplete: media, transcript and separated tracks;generation.completed
- from
processing:failed,error.code;generation.failed
status. transcription_status and stems_status can still be preparing just after complete.Webhooksgeneration.completed, generation.failed (Webhooks)
Limits
| Limit | Value |
|---|---|
| Billing | whole seconds, 60 second minimum per restore |
| Media URLs | 6 hours (expires_at); ask again for new ones |
preview_seconds | 4 to 3600, rounded up to whole 4 second segments |
| label | up to 120 characters |
SDK wait | polls every 2 seconds, gives up after 3600 seconds by default |
| List page | limit 1 to 100, default 20, newest first |
Build with it
- Guide Quickstart
- Guide Podcast cleanup in a SaaS app