Skip to content
From separated tracks to a file.
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/separated-tracks.md, and every docs URL returns Markdown when requested with Accept: text/markdown.

Separated tracks: mix and exports
A restore keeps the speech and the background as two separated tracks (stems_status).A mix is a saved balance of the two (background_gain); an export renders speech, background, a mix or both as a file.
How it works
stems ready:stems_status: "ready";generation.stems_readymix saved:PUT …/mixwithbackground_gainand therevisionyou readexport queued:POST …/exports; the same recipe returns the same exportexport ready:urlto download;export.ready
- from
stems ready:stems failed,generation.stems_failed; mix and exports answer409 not_available - from
export queued:export failed,export.failed; asking again renders it again
Webhooksgeneration.stems_ready, generation.stems_failed, export.ready, export.failed (Webhooks)
Limits
| Limit | Value |
|---|---|
background_gain | 0 (speech only) to 1 (all of the background) |
| speech, background, mix | wav, mp3, m4a or mp4 |
| both | zip of the two tracks |
| original | inline only, mp3 or mp4 |
| Inline exports | mp3 or mp4, to play in a page |
| Exports rendering | 4 per generation at once; more is 409 too_many_exports |
file_name | up to 200 characters, without the extension |