# Supertone API Documentation

> Empowering Voices, Simplifying AI Integration

## Docs

- [Service Discontinuation](https://supertone-b89202c8.mintlify.app/en/docs/sunset.md): Supertone API will be discontinued on August 31, 2026. What this means for you, key dates, and how refunds are handled.
- [Introduction](https://supertone-b89202c8.mintlify.app/en/api-reference/introduction.md): REST API reference for the Supertone TTS platform — endpoints, parameters, and response schemas.
- [Authentication](https://supertone-b89202c8.mintlify.app/en/api-reference/authentication.md): All Supertone API requests authenticate with an API key sent in the `x-sup-api-key` header.
- [List voices](https://supertone-b89202c8.mintlify.app/en/api-reference/endpoints/list-voices.md): Retrieve all preset voices available to your account.
- [Search voices](https://supertone-b89202c8.mintlify.app/en/api-reference/endpoints/search-voices.md): Filter the preset voice library by language, style, gender, age, use case, or model.
- [Get voice](https://supertone-b89202c8.mintlify.app/en/api-reference/endpoints/get-voice.md): Retrieve a single preset voice by ID.
- [List custom voices](https://supertone-b89202c8.mintlify.app/en/api-reference/endpoints/list-custom-voices.md): Retrieve all custom (cloned) voices registered on your account.
- [Search custom voices](https://supertone-b89202c8.mintlify.app/en/api-reference/endpoints/search-custom-voices.md): Filter your custom (cloned) voices by name or description.
- [Get custom voice](https://supertone-b89202c8.mintlify.app/en/api-reference/endpoints/get-custom-voice.md): Retrieve a single custom (cloned) voice by ID.
- [Delete custom voice](https://supertone-b89202c8.mintlify.app/en/api-reference/endpoints/delete-custom-voice.md): Permanently delete a custom (cloned) voice from your account.
- [Edit custom voice](https://supertone-b89202c8.mintlify.app/en/api-reference/endpoints/edit-custom-voice.md): Update the name or description of a custom (cloned) voice.
- [Create cloned voice](https://supertone-b89202c8.mintlify.app/en/api-reference/endpoints/create-cloned-voice.md): Register a new custom voice by uploading a sample audio file.
- [Create speech](https://supertone-b89202c8.mintlify.app/en/api-reference/endpoints/text-to-speech.md): Convert text into a complete audio file using a voice of your choice.
- [Stream speech](https://supertone-b89202c8.mintlify.app/en/api-reference/endpoints/stream-text-to-speech.md): Convert text to speech and return the output as a chunked audio stream.
- [Predict duration](https://supertone-b89202c8.mintlify.app/en/api-reference/endpoints/predict-duration.md): Estimate the length of generated speech for a given text — without producing audio or consuming credits.
- [Get usage](https://supertone-b89202c8.mintlify.app/en/api-reference/endpoints/get-usage.md): Bucketed usage analytics with breakdowns by voice, API key, or model — ideal for dashboards and reporting.
- [Get voice usage](https://supertone-b89202c8.mintlify.app/en/api-reference/endpoints/get-voice-usage.md): Per-voice usage history aggregated by date — generated minutes per `(date, voice, style, language, model)`.
- [Get credit balance](https://supertone-b89202c8.mintlify.app/en/api-reference/endpoints/get-credit-balance.md): Return the available credit balance on your account.

## OpenAPI Specs

- [openapi](https://supertone-b89202c8.mintlify.app/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.