> For the complete documentation index, see [llms.txt](https://diffio.ai/llms.txt). This page is also available as HTML at https://diffio.ai/docs/overview/concepts/generations/.

# 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`.**

Webhooks `generation.completed`, `generation.failed` ([Webhooks](https://diffio.ai/docs/developers/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](https://diffio.ai/docs/developers/quick-start/)
- Guide [Podcast cleanup in a SaaS app](https://diffio.ai/docs/developers/guides/saas-podcast-cleanup/)

- [`POST /projects/{project_id}/generations`](https://diffio.ai/docs/api-reference/create-generation/)
- [`GET /projects/{project_id}/generations/{generation_id}`](https://diffio.ai/docs/api-reference/get-generation/)
- [`GET /projects/{project_id}/generations`](https://diffio.ai/docs/api-reference/list-project-generations/)
- [`GET /projects/{project_id}/generations/{generation_id}/media`](https://diffio.ai/docs/api-reference/get-generation-media/)
- [`GET /models`](https://diffio.ai/docs/api-reference/list-models/)

## Related pages

- Previous: [Projects and uploads](https://diffio.ai/docs/overview/concepts/projects-and-uploads/): A project holds one uploaded recording; its status moves from awaiting_upload to ready as the file arrives.
- Next: [Transcripts and edits](https://diffio.ai/docs/overview/concepts/transcripts-and-edits/): Every generation has a word-timed transcript; change its words on a Pro result and Diffio restores the changed parts again.
