Skip to content

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

  1. stems ready: stems_status: "ready"; generation.stems_ready
  2. mix saved: PUT …/mix with background_gain and the revision you read
  3. export queued: POST …/exports; the same recipe returns the same export
  4. export ready: url to download; export.ready
  • from stems ready: stems failed, generation.stems_failed; mix and exports answer 409 not_available
  • from export queued: export failed, export.failed; asking again renders it again
From separated tracks to a file.

Webhooksgeneration.stems_ready, generation.stems_failed, export.ready, export.failed (Webhooks)

Limits

LimitValue
background_gain0 (speech only) to 1 (all of the background)
speech, background, mixwav, mp3, m4a or mp4
bothzip of the two tracks
originalinline only, mp3 or mp4
Inline exportsmp3 or mp4, to play in a page
Exports rendering4 per generation at once; more is 409 too_many_exports
file_nameup to 200 characters, without the extension

Build with it

Report an issue with this page