Skip to content
From a transcript to an edited recording.
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/transcripts-and-edits.md, and every docs URL returns Markdown when requested with Accept: text/markdown.

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
transcript ready:transcription_status: "ready"on a complete Pro generationestimate:POST …/edits/estimate: the most it can bill; creates nothingedit:POST …/edits: a new generation,kind: "edit"complete: the whole recording with the changes; its own transcript
- from
transcript ready:not editable, not Pro, or the transcript failed:409
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
- Guide Let users edit by asking
GET /projects/{project_id}/generations/{generation_id}/transcriptPOST /projects/{project_id}/generations/{generation_id}/edits/estimatePOST /projects/{project_id}/generations/{generation_id}/editsGET /projects/{project_id}/generations/{generation_id}/transcript/draftPOST /projects/{project_id}/generations/{generation_id}/transcript/assistant/turns