> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://onepin.ai/docs/guides/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://onepin.ai/_mcp/server.

# Guides

> Onepin is a voice workflow platform that orchestrates, validates, and ships production-ready audio across 33 TTS models.

## Docs

- [Run a workflow](https://onepin.ai/docs/guides/run-a-workflow.md): Start a workflow run, watch it finish, and download the audio — in Python or the CLI.
- [Use your own script](https://onepin.ai/docs/guides/use-your-own-script.md): Run a workflow with per-request text — no editing the saved workflow.
- [Translate into other languages](https://onepin.ai/docs/guides/translate.md): Add a Translator node, pick target languages, assign a voice per language (or let auto-route pick), and get per-language audio from one Onepin run.
- [Auto-route](https://onepin.ai/docs/guides/auto-route.md): How Onepin auto-routing works — leave a language's voice_map empty and continuous benchmarks pick the model; tune the balance between performance and cost per workspace.
- [Validate every line](https://onepin.ai/docs/guides/validate-every-line.md): Build a fully validated Onepin pipeline — chain the Accuracy, Naturalness, Noise, and Pronunciation validators with retry loops so every exported line has cleared every bar.
- [Generate long-form audio](https://onepin.ai/docs/guides/long-form-audio.md): Generate hours of audio in one Onepin run — upload a long script file, understand the per-node limits, and assemble the per-line output files using manifest.csv.
- [Fix pronunciations](https://onepin.ai/docs/guides/fix-pronunciations.md): Fix mispronounced names and terms in Onepin — the Phoneme Injector, Pronunciation validator, and Pronunciation Corrector chain inside a run, plus the workspace dictionary as your team's record.
- [Browse voices](https://onepin.ai/docs/guides/browse-voices.md): List the voices available to your workspace, search them in plain language, and hear one before you commit.
- [Bring your own key](https://onepin.ai/docs/guides/bring-your-own-key.md): Connect your own TTS provider API key (BYOK) to a Onepin workspace. What it changes for routing, credits, imported voices, and what happens when a key stops working.
- [Use templates](https://onepin.ai/docs/guides/use-templates.md): Browse the gallery and clone a template into a workflow you can run.
- [Upload a file](https://onepin.ai/docs/guides/upload-a-file.md): Upload a script or dictionary file and bind it to a workflow.
- [Check usage](https://onepin.ai/docs/guides/check-usage.md): See what your workspace consumed, and what a run will cost before you start it.
- [Handle errors](https://onepin.ai/docs/guides/handle-errors.md): Catch API errors in Python and read exit codes in the CLI.