Blog

Supertone Play TTS API tutorial

September 8, 2025

1. Getting Started with API

Q. Where can I get an API Key?

A. You can get an API Key immediately upon signing up for the service when you log in to the API Console. You can generate and use up to 3 keys per account, and if leaked, you can delete and re-issue them from the Console.

Q. How do I integrate the API?

A. You can make requests by authenticating with the issued API Key included in the HTTP header. Please refer to the official documentation for detailed integration methods.

Q. Where can I check available voices?

A. You can check voice IDs and style information through the Play Voice Library or the Get/Search Voices API.

Q. Where can I check my credit balance?

A. You can check it by calling the Get Credit Balance API, or in the Console or your Play My Page.

Q. Can I predict the length before generating audio?

A. You can use the Predict Duration API to check in advance how many seconds of audio will be generated from the entered text. This API can be called without credits.

2. Frequently Asked Questions

Q. How do I pay to use the API?

A. We use the same credit system as Play. You can charge credits by subscribing to a plan or topping up individually.

Q. Can I use cloned voices in the API?

A. Yes. Cloned voices created in Play can be called identically in the API. However, cloned voice creation is only available in Play.

Q. Can I reuse audio generated in Play with the API?

A. Cloned voices created under the same account can be called in the API without any special settings.

Q. How is the API connected to Play?

A. Play and the API share the same account, credits, and voice library.

Q. Are credits only deducted in the API?

A. No. Play and the API share the same credits, so they are deducted when used in either.

3. Basic Troubleshooting

Q. It says my API Key is invalid.

A. Please check if the entered Key is correct. If it has expired or been deleted, you need to re-issue it from the Console.

Q. It says I have insufficient credits.

A. Please upgrade your plan or top up additional credits in Play.

Q. Audio is not being generated.

A. Please check if parameters such as language, style, and model are entered correctly. If the error persists, please refer to the official documentation > Error Support (link).

Q. Where can I find more detailed technical error information?

A. You can find it on the official documentation > Error Support (link).

View All Latest

< <