> 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/developers/guides/.

# Use-case guides

Short recipes on the Diffio API. Each one is a diagram, a few steps and one complete file in Python and Node.

## Guides

- [Podcast cleanup in a SaaS app: Your users upload episodes from the browser straight to Diffio, your server keeps the API key and each user's projects apart, and a signed webhook tells you when the cleaned audio is ready to play. You get: Restored episodes for each customer, ready to play. Calls: Browser upload → webhook → player](https://diffio.ai/docs/developers/guides/saas-podcast-cleanup/)
- [Edit a transcript: Change a word in a Pro result's transcript and get back the whole recording with the new word said in the same voice. You get: The whole recording with one word replaced. Calls: Transcript → estimate → edit](https://diffio.ai/docs/developers/guides/edit-transcript/)
- [Let users edit by asking: Let people ask for changes in plain words, show the assistant's proposals, and turn the one they accept into an edit. You get: Proposed edits from a plain request, one applied. Calls: Ask → proposals → edit](https://diffio.ai/docs/developers/guides/edit-by-asking/)
- [Separate speech and background: Turn the background down under the restored speech, save that balance, and download it as an MP3. You get: An MP3 with the background turned down. Calls: Stems → mix → export](https://diffio.ai/docs/developers/guides/separate-speech-and-background/)
- [Share a restored result: Give anyone a link that plays a restored recording, read it from a public page without an API key, and turn it off when you are done. You get: A public link that plays the restored audio. Calls: Publish → public read → revoke](https://diffio.ai/docs/developers/guides/share-a-result/)
- [Restore a video and stream it: Restore the speech in a video, download the restored MP4, and stream the result in a browser with hls.js. You get: A restored MP4 and an HLS stream with the picture. Calls: Video upload → HLS stream](https://diffio.ai/docs/developers/guides/restore-video-and-stream/)
- [Compare Flash and Pro: Restore one recording with both models, listen to them side by side, and see what each one cost. You get: Original, Flash and Pro side by side, with their cost. Calls: One project → two generations](https://diffio.ai/docs/developers/guides/compare-flash-and-pro/)
- [Clean up a back catalogue: Restore every recording in a folder, a few at a time, pick up where a stopped run left off, and total what it used. You get: A restored copy of every file, and the run's usage. Calls: Folder → restores → usage](https://diffio.ai/docs/developers/guides/clean-up-a-back-catalogue/)
- [Bill your users from usage: Read each customer's Diffio usage for a billing period and turn it into one line on their invoice. You get: One invoice line per customer. Calls: Usage per end user → invoice](https://diffio.ai/docs/developers/guides/bill-users-from-usage/)

## Before you start

An API key in `DIFFIO_API_KEY` and the SDK (`pip install diffio` or `npm install diffio`): the [Quickstart](https://diffio.ai/docs/developers/quick-start/) covers both. The ideas behind the calls are in [Concepts](https://diffio.ai/docs/overview/concepts/projects-and-uploads/).
