---
title: "Clone voice (TTS)"
method: POST
path: "/job/add/paperoffice_voice___tts"
tags: ["Media AI — Voice"]
---

# Clone voice (TTS)

`POST /job/add/paperoffice_voice___tts`

## Request

- Base URL: `https://api.paperoffice.ai/latest`
- URL: `https://api.paperoffice.ai/latest/job/add/paperoffice_voice___tts`
- Auth: HTTP bearer

TTS voice clone: POST /job/add/paperoffice_voice___tts with voice_sample file (no catalog voice). quality premium|ultra only. Sample min 10s; reference_text (alias voice_sample_text) strongly recommended. Defaults: premium, inline, mp3...

This operation has 3 documented variants (same method and path, different fields):
- [Clone voice (TTS)](https://api.paperoffice.ai/latest/docs/endpoints/po-tts-voice-cloning.md) — TTS voice clone: POST /job/add/paperoffice_voice___tts with voice_sample file (no catalog voice). quality premium|ultra only. Sample min 10s; reference_text (alias voice_sample_text) strongly recommended. Defaults: premium, inline, mp3...
- [Generate multi-speaker TTS (inline tags)](https://api.paperoffice.ai/latest/docs/endpoints/po-tts-multivoice-4-speakers.md) — TTS multi-speaker: POST /job/add/paperoffice_voice___tts with voice=Multi and inline speaker tags. Requires text, voice, language. Catalog names from POST /voice/voices. Tag syntax: XML, [lang|Name], or [voice:Name lang:xx]. Hybrid...
- [Generate speech (single voice)](https://api.paperoffice.ai/latest/docs/endpoints/po-tts-generate-speech.md) — TTS single voice: language wins on mismatch, voice substituted (Abigail+language=de → Anneliese, warnings[]). POST /job/add/paperoffice_voice___tts. Requires text, voice, language (POST /voice/voices). Defaults: voice=Abigail...

## Response `200`

Success

- SuccessEnvelope: Success envelope. Payload fields are endpoint-specific (top-level fields, `result`/`job_result` for jobs, `data` on some account endpoints).
  - `status` 'success', required
  - `processing_time` union
    - string
    - number
  - `_billing` object

## Other responses

- `202`: Accepted — job continues in the background
- `4XX`: Error
- `5XX`: Error

---

[API](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api.md) · [All operations](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api/revisions/c6a6228a4509?raw)