> 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/transcripts-and-edits/.

# Transcripts and edits

A generation's transcript is its words in order, each with an `id`, `text`, `start` and `end`. On a finished `diffio-pro` result, send the words back with changes: only the windows around them are restored, as a new generation of `kind` `edit`.

## How it works

1. `transcript ready`: `transcription_status: "ready"` on a complete Pro generation
2. `estimate`: `POST …/edits/estimate`: the most it can bill; creates nothing
3. `edit`: `POST …/edits`: a new generation, `kind: "edit"`
4. `complete`: the whole recording with the changes; its own transcript

- from `transcript ready`: `not editable`, not Pro, or the transcript failed: `409`

**From a transcript to an edited recording.**

## Limits

| Limit | Value |
| --- | --- |
| Who can edit | finished `diffio-pro` results (`transcript_editable: true`) |
| Edit billing | 30 seconds per restored window, no minimum; an edit that only cuts bills nothing |
| `request_id` | up to 64 characters, `A-Z a-z 0-9 _ -` |
| `tighten` | audio projects only |
| Edit assistant | up to 30 turns per 10 minutes, plus a daily cap |
| Drafts | one per generation; a stale `revision` is `409 revision_conflict` |

## Build with it

- Guide [Edit a transcript](https://diffio.ai/docs/developers/guides/edit-transcript/)
- Guide [Let users edit by asking](https://diffio.ai/docs/developers/guides/edit-by-asking/)

- [`GET /projects/{project_id}/generations/{generation_id}/transcript`](https://diffio.ai/docs/api-reference/get-transcript/)
- [`POST /projects/{project_id}/generations/{generation_id}/edits/estimate`](https://diffio.ai/docs/api-reference/estimate-transcript-edit/)
- [`POST /projects/{project_id}/generations/{generation_id}/edits`](https://diffio.ai/docs/api-reference/create-transcript-edit/)
- [`GET /projects/{project_id}/generations/{generation_id}/transcript/draft`](https://diffio.ai/docs/api-reference/get-transcript-draft/)
- [`POST /projects/{project_id}/generations/{generation_id}/transcript/assistant/turns`](https://diffio.ai/docs/api-reference/create-transcript-assistant-turn/)

## Related pages

- Previous: [Generations](https://diffio.ai/docs/overview/concepts/generations/): A generation is one restore of a project with one model; follow its status and stage, then read its media.
- Next: [Separated tracks](https://diffio.ai/docs/overview/concepts/separated-tracks/): Each restore separates speech from background; save a balance of the two and render it as a downloadable export.
