# Onepin

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

## Instructions for AI Agents

- For clean Markdown of any page, append `.md` to the page URL
- For section-specific indexes, append `/llms.txt` to any section URL
- For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://onepin.ai/_mcp/server

## Docs

- [Onepin](https://onepin.ai/docs/get-started/introduction.md): Onepin orchestrates, validates, and ships production-ready audio across 33 TTS models — REST API, Python SDK, and CLI for building multi-step voice workflows.
- [Quickstart](https://onepin.ai/docs/get-started/quickstart.md): From zero to downloaded audio in about 5 minutes — in Python or from the terminal.
- [Authentication](https://onepin.ai/docs/get-started/authentication.md): Authenticate the Onepin SDK and CLI with an API key.
- [MCP server](https://onepin.ai/docs/get-started/mcp-server.md): Onepin's remote MCP server lets an agent browse voices, author and validate workflows, price a run, start it, and hand the audio back — over OAuth, with no API key.
- [Agent skill](https://onepin.ai/docs/get-started/agent-skill.md): The onepin package ships an Agent Skill that teaches your AI coding tool to drive the Onepin CLI — installed with a single command, offline, no extra config.
- [Voices & Models](https://onepin.ai/docs/get-started/voices-models.md): Onepin orchestrates audio across 33 TTS models from 19 providers — ElevenLabs, Cartesia, Microsoft Azure, Google Cloud, Inworld, Rime, OpenAI, MiniMax, and more. Browse the live catalog via API or CLI.
- [Workflow](https://onepin.ai/docs/workflow/overview.md): How an Onepin workflow definition works — the graph of Source, Operator, Validator, and Sink nodes, how a line of script becomes finished audio, and how to edit a definition in code.
- [General rules](https://onepin.ai/docs/workflow/general-rules.md): The rules an Onepin workflow definition must satisfy — required nodes, port compatibility, connectedness, validator routing, and retry loops.
- [Script](https://onepin.ai/docs/workflow/script.md): The Onepin Script node (source_script) — the source of every line. Configure inline text or an uploaded .txt/.pdf file, plus the source language.
- [Translator](https://onepin.ai/docs/workflow/translator.md): The Onepin Translator node (operator_translator) — translate a script into up to 30 target languages, with a Generator downstream for each one.
- [Normalizer](https://onepin.ai/docs/workflow/normalizer.md): The Onepin Normalizer node (operator_normalizer) — expands numbers, dates, and symbols into their spoken form before generation.
- [Generator](https://onepin.ai/docs/workflow/generator.md): The Onepin Generator node (operator_generator) — the TTS engine. Configure voice_map to assign a provider voice and a catalog model per language, and get the two identifiers right.
- [Phoneme Injector](https://onepin.ai/docs/workflow/phoneme-injector.md): The Onepin Phoneme Injector node (operator_phoneme_injector) — names the words worth checking, looks them up in the built-in pronunciation reference, and attaches per-word pronunciation to each line.
- [Pronunciation Corrector](https://onepin.ai/docs/workflow/pronunciation-corrector.md): The Onepin Pronunciation Corrector node (operator_pronunciation_corrector) — replaces only the words the Pronunciation validator flagged, keeping the surrounding audio and the voice unchanged.
- [Validators](https://onepin.ai/docs/workflow/validators.md): How Onepin validators work — the pass and fail outputs, wiring pass to Export and fail back to the Generator, what retry and threshold mean, and chaining vs parallel checks.
- [Accuracy validator](https://onepin.ai/docs/workflow/accuracy-validator.md): The Onepin Accuracy validator (validator_error_rate) — transcribes generated audio and compares it to the script, scoring word accuracy and retrying failing lines.
- [Naturalness validator](https://onepin.ai/docs/workflow/naturalness-validator.md): The Onepin Naturalness validator (validator_naturalness) — scores generated speech for naturalness on a 0–100 scale and retries lines below the threshold.
- [Noise validator](https://onepin.ai/docs/workflow/noise-validator.md): The Onepin Noise validator (validator_noise) — scores generated audio for clarity on a 0–100 scale, flagging background noise and artifacts, and retries lines below the threshold.
- [Pronunciation validator](https://onepin.ai/docs/workflow/pronunciation-validator.md): The Onepin Pronunciation validator (validator_pronunciation) — scores segmental pronunciation phoneme by phoneme, producing a 0–100 score from the phoneme error rate, and retries lines below the threshold.
- [Export](https://onepin.ai/docs/workflow/export.md): The Onepin Export node (sink_preview) — produces the final audio files. Choose wav or mp3; the run's download is a ZIP of the audio plus a manifest.csv.
- [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.
- [SDK reference](https://onepin.ai/docs/reference/sdk-reference.md): The onepin Python client — construction and every resource method.
- [CLI reference](https://onepin.ai/docs/reference/cli-reference.md): Every onepin command, flag, and exit code.
- [Glossary](https://onepin.ai/docs/reference/glossary.md): A glossary of voice and TTS terminology used across Onepin and the wider voice-AI field — TTS, STT, WER, MOS, prosody, phoneme, voice_map, and more, in plain language.

## API Docs

- API Reference > auth [Whoami](https://onepin.ai/docs/reference/api-reference/auth/whoami-api-v-1-auth-whoami-get.md)
- API Reference > nodes [List Nodes](https://onepin.ai/docs/reference/api-reference/nodes/list-nodes-api-v-1-nodes-get.md)
- API Reference > nodes [Get Node Detail](https://onepin.ai/docs/reference/api-reference/nodes/get-node-detail-api-v-1-nodes-node-type-get.md)
- API Reference > nodes [Get Node Detail V2](https://onepin.ai/docs/reference/api-reference/nodes/get-node-detail-v-2.md)
- API Reference > providers [List Catalog Providers](https://onepin.ai/docs/reference/api-reference/providers/list-catalog-providers-api-v-1-providers-get.md)
- API Reference > providers [Get Catalog Provider](https://onepin.ai/docs/reference/api-reference/providers/get-catalog-provider-api-v-1-providers-provider-get.md)
- API Reference > providers [List Catalog Provider Models](https://onepin.ai/docs/reference/api-reference/providers/list-catalog-provider-models-api-v-1-providers-provider-models-get.md)
- API Reference > providers [List Catalog Provider Model Voices](https://onepin.ai/docs/reference/api-reference/providers/list-catalog-provider-model-voices-api-v-1-providers-provider-models-model-voices-get.md)
- API Reference > providers [Get Catalog Provider Model](https://onepin.ai/docs/reference/api-reference/providers/get-catalog-provider-model-api-v-1-providers-provider-models-model-get.md)
- API Reference > templates [List Templates](https://onepin.ai/docs/reference/api-reference/templates/list.md)
- API Reference > templates [Create Template](https://onepin.ai/docs/reference/api-reference/templates/create-template-api-v-1-templates-post.md)
- API Reference > templates [Get Template](https://onepin.ai/docs/reference/api-reference/templates/get.md)
- API Reference > templates [Delete Template](https://onepin.ai/docs/reference/api-reference/templates/delete-template-api-v-1-templates-template-id-delete.md)
- API Reference > templates [Update Template](https://onepin.ai/docs/reference/api-reference/templates/update-template-api-v-1-templates-template-id-patch.md)
- API Reference > templates [Estimate Template](https://onepin.ai/docs/reference/api-reference/templates/estimate-template-api-v-1-templates-template-id-estimate-get.md)
- API Reference > templates [Clone Template](https://onepin.ai/docs/reference/api-reference/templates/clone.md)
- API Reference > templates [Favorite Template](https://onepin.ai/docs/reference/api-reference/templates/favorite-template-api-v-1-templates-template-id-favorite-post.md)
- API Reference > templates [Unfavorite Template](https://onepin.ai/docs/reference/api-reference/templates/unfavorite-template-api-v-1-templates-template-id-favorite-delete.md)
- API Reference > voices [List Voices](https://onepin.ai/docs/reference/api-reference/voices/list.md)
- API Reference > voices [Get Voice Facets](https://onepin.ai/docs/reference/api-reference/voices/get-voice-facets-api-v-1-voices-facets-get.md)
- API Reference > voices [Get Voice](https://onepin.ai/docs/reference/api-reference/voices/get.md)
- API Reference > voices [Get Similar Voices](https://onepin.ai/docs/reference/api-reference/voices/similar.md)
- API Reference > voices [Get Voice Preview](https://onepin.ai/docs/reference/api-reference/voices/preview.md)
- API Reference > voices [Favorite Voice](https://onepin.ai/docs/reference/api-reference/voices/favorite-voice-api-v-1-voices-voice-id-favorite-post.md)
- API Reference > voices [Unfavorite Voice](https://onepin.ai/docs/reference/api-reference/voices/unfavorite-voice-api-v-1-voices-voice-id-favorite-delete.md)
- API Reference > workspace [Get Workspace Settings](https://onepin.ai/docs/reference/api-reference/workspace/get-workspace-settings-api-v-1-workspaces-ws-id-settings-get.md)
- API Reference > workspace-members [List Members](https://onepin.ai/docs/reference/api-reference/workspace-members/list-members-api-v-1-workspaces-ws-id-members-get.md)
- API Reference > workspace-members [Create Invite](https://onepin.ai/docs/reference/api-reference/workspace-members/create-invite-api-v-1-workspaces-ws-id-invites-post.md)
- API Reference > workspace-members [Remove Member](https://onepin.ai/docs/reference/api-reference/workspace-members/remove-member-api-v-1-workspaces-ws-id-members-member-id-delete.md)
- API Reference > workspace-members [Update Member Role](https://onepin.ai/docs/reference/api-reference/workspace-members/update-member-role-api-v-1-workspaces-ws-id-members-member-id-patch.md)
- API Reference > workspace-members [Revoke Invite](https://onepin.ai/docs/reference/api-reference/workspace-members/revoke-invite-api-v-1-workspaces-ws-id-invites-invite-id-delete.md)
- API Reference > workspace-members [Update Invite Role](https://onepin.ai/docs/reference/api-reference/workspace-members/update-invite-role-api-v-1-workspaces-ws-id-invites-invite-id-patch.md)
- API Reference > workspace-members [Accept Invite](https://onepin.ai/docs/reference/api-reference/workspace-members/accept-invite-api-v-1-workspaces-invites-token-accept-post.md)
- API Reference > workspaces [List Workspaces](https://onepin.ai/docs/reference/api-reference/workspaces/list-workspaces-api-v-1-workspaces-get.md)
- API Reference > workspaces [Create Workspace](https://onepin.ai/docs/reference/api-reference/workspaces/create-workspace-api-v-1-workspaces-post.md)
- API Reference > workspaces [Slug Available](https://onepin.ai/docs/reference/api-reference/workspaces/slug-available-api-v-1-workspaces-slug-available-get.md)
- API Reference > workspaces [Get Workspace](https://onepin.ai/docs/reference/api-reference/workspaces/get-workspace-api-v-1-workspaces-workspace-id-get.md)
- API Reference > workspaces [Update Workspace](https://onepin.ai/docs/reference/api-reference/workspaces/update-workspace-api-v-1-workspaces-workspace-id-patch.md)
- API Reference > uploads [Create Upload](https://onepin.ai/docs/reference/api-reference/uploads/create.md)
- API Reference > uploads [Confirm Upload](https://onepin.ai/docs/reference/api-reference/uploads/confirm.md)
- API Reference > uploads [Delete Upload](https://onepin.ai/docs/reference/api-reference/uploads/delete.md)
- API Reference > usage [Usage Summary](https://onepin.ai/docs/reference/api-reference/usage/summary-api-v-1-usage-summary-get.md)
- API Reference > usage [Usage By Language](https://onepin.ai/docs/reference/api-reference/usage/by-language-api-v-1-usage-by-language-get.md)
- API Reference > usage [Usage Activity](https://onepin.ai/docs/reference/api-reference/usage/activity-api-v-1-usage-activity-get.md)
- API Reference > workflows [List Workflows](https://onepin.ai/docs/reference/api-reference/workflows/list.md)
- API Reference > workflows [Create Workflow](https://onepin.ai/docs/reference/api-reference/workflows/create-workflow-api-v-1-workflows-post.md)
- API Reference > workflows [Check Workflow Name Availability](https://onepin.ai/docs/reference/api-reference/workflows/check-workflow-name-availability-api-v-1-workflows-name-availability-get.md)
- API Reference > workflows [Get Workflow](https://onepin.ai/docs/reference/api-reference/workflows/get.md)
- API Reference > workflows [Update Workflow](https://onepin.ai/docs/reference/api-reference/workflows/update-workflow-api-v-1-workflows-workflow-id-put.md)
- API Reference > workflows [Delete Workflow](https://onepin.ai/docs/reference/api-reference/workflows/delete-workflow-api-v-1-workflows-workflow-id-delete.md)
- API Reference > workflows [Patch Workflow](https://onepin.ai/docs/reference/api-reference/workflows/patch-workflow-api-v-1-workflows-workflow-id-patch.md)
- API Reference > workflows [Get Workflow Markdown](https://onepin.ai/docs/reference/api-reference/workflows/get-workflow-markdown-api-v-1-workflows-workflow-id-markdown-get.md)
- API Reference > workflows [List Workflow Uploads](https://onepin.ai/docs/reference/api-reference/workflows/list-workflow-uploads-api-v-1-workflows-workflow-id-uploads-get.md)
- API Reference > workflows [Estimate Workflow](https://onepin.ai/docs/reference/api-reference/workflows/estimate-workflow-api-v-1-workflows-workflow-id-estimate-post.md)
- API Reference > workflows [Preview Run](https://onepin.ai/docs/reference/api-reference/workflows/preview-run-api-v-1-workflows-workflow-id-runs-preview-post.md)
- API Reference > workflows [Runs Summary](https://onepin.ai/docs/reference/api-reference/workflows/runs-summary-api-v-1-workflows-workflow-id-runs-summary-get.md)
- API Reference > workflows [Get Run Outputs](https://onepin.ai/docs/reference/api-reference/workflows/get-run-outputs-api-v-1-workflows-workflow-id-runs-run-id-outputs-get.md)
- API Reference > workflows [Get Run Overview](https://onepin.ai/docs/reference/api-reference/workflows/get-run-overview-api-v-1-workflows-workflow-id-runs-run-id-overview-get.md)
- API Reference > workflows [Get Run Analysis](https://onepin.ai/docs/reference/api-reference/workflows/get-run-analysis-api-v-1-workflows-workflow-id-runs-run-id-analysis-get.md)
- API Reference > workflows [Get Run Data](https://onepin.ai/docs/reference/api-reference/workflows/get-run-data-api-v-1-workflows-workflow-id-runs-run-id-data-get.md)
- API Reference > workflows [Download Run](https://onepin.ai/docs/reference/api-reference/workflows/download-run-api-v-1-workflows-workflow-id-runs-run-id-download-get.md)
- API Reference > workflows [Get Run Audio Url](https://onepin.ai/docs/reference/api-reference/workflows/get-run-audio-url-api-v-1-workflows-workflow-id-runs-run-id-audio-audio-id-url-get.md)
- API Reference > workflows [Download Run Node](https://onepin.ai/docs/reference/api-reference/workflows/download-run-node-api-v-1-workflows-workflow-id-runs-run-id-nodes-node-id-download-get.md)
- API Reference > workflows [Pause Run](https://onepin.ai/docs/reference/api-reference/workflows/pause-run-api-v-1-workflows-workflow-id-runs-run-id-pause-post.md)
- API Reference > workflows [Resume Run](https://onepin.ai/docs/reference/api-reference/workflows/resume-run-api-v-1-workflows-workflow-id-runs-run-id-resume-post.md)
- API Reference > workflows [Validate Workflow](https://onepin.ai/docs/reference/api-reference/workflows/validate-workflow-api-v-1-workflows-validate-post.md)
- API Reference > workflows [Duplicate Workflow](https://onepin.ai/docs/reference/api-reference/workflows/duplicate-workflow-api-v-1-workflows-workflow-id-duplicate-post.md)
- API Reference > workflows > Runs [List Runs](https://onepin.ai/docs/reference/api-reference/workflows/runs/list.md)
- API Reference > workflows > Runs [Start Run](https://onepin.ai/docs/reference/api-reference/workflows/runs/start.md)
- API Reference > workflows > Runs [Get Run](https://onepin.ai/docs/reference/api-reference/workflows/runs/get.md)
- API Reference > workflows > Runs [Get Run Status](https://onepin.ai/docs/reference/api-reference/workflows/runs/status.md)
- API Reference > workflows > Runs [Get Run Steps](https://onepin.ai/docs/reference/api-reference/workflows/runs/steps.md)
- API Reference > workflows > Runs [Cancel Run](https://onepin.ai/docs/reference/api-reference/workflows/runs/cancel.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://onepin.ai/docs/openapi.json)
- [OpenAPI YAML](https://onepin.ai/docs/openapi.yaml)