Getting Started
Support & Resources
Latest Updates
Frequently Asked Questions
Weโve compiled frequently asked questions and their answers during API usage.
Weโve organized the most frequently asked questions by topic, from those first using the API to users who have integrated cloned voices.
1. Get Started with API
You can get it immediately by signing up for the service in the console. You can use up to 3 Keys per account, and revocation and reissuance are possible in case of leakage.
When making HTTP requests, put the issued Key in the x-sup-api-key header. For detailed integration methods, please refer to Quick Start.
No. Play and API operate on the same account basis.
2. Voice & API Calls
Voice IDs can be checked through the following three methods:
- Copy from the voice library in Supertone Play
- Call GET /v1/voices endpoint for complete inquiry
- Call GET /v1/voices/search endpoint for conditional search For more details, please check the Voice Selection Guide.
Yes. Cloned voices created in Play can also be called in the API with the same account. Cloned voice creation is only possible in Play.
By searching with GET /v1/voices/search?name=My Voice, you can filter and check only cloned voices created within your account.
For more details, please check the Voice Selection Guide.
No. In addition to voice_id, the language, style, and model combination must match exactly for voice to be generated normally.
Through the samples field, you can check supported language/style/model combinations and sample audio for each voice.
For more details, please check the Voice Selection Guide.
No. Style is optional, and the systemโs default style is automatically applied if not provided.
You can adjust pitch_shift, pitch_variance, and speed through voice_settings.
Itโs a feature that predicts the speech length of input text. Credits are not deducted.
3. Credit & Pricing
It uses the same credit system as Play. Please check available plans on the Play subscription page.
You can check through the following two methods:
- Call
GET /v1/creditsAPI - Check console or Play dashboard
No. Play and API share the same credits.
Yes. Cloned voices created within the same account can be called in the API without additional settings.
4. Errors & Troubleshooting
- 401: API Key error
- 402: Insufficient credits
- 403: Unauthorized voice call
- 400: Parameter error, text overflow, etc.
- 429: Call limit exceeded For more details, please check the Error Handling guide.
You can check them in the Error Handling guide.
Please refer to the Error Handling guide and check the following:
- Verify that x-sup-api-key is included in headers
- Check if Content-Type: application/json is missing
- Verify that voice_id has been replaced with actual value If problems persist, please contact through the customer support page.
We recommend 20 calls or fewer per minute by default. For higher traffic needs, separate inquiry is required.
๐ข Enterprise Inquiry
5. Operational Policy & Support
Yes. You can use it immediately after signing up for the console and charging credits, with no separate approval required.
Yes. For team-level usage, user account separation, call limit expansion, and other special conditions, please contact through support.
๐ข Enterprise Inquiry
Please leave a 1:1 inquiry through the customer support page, and weโll respond quickly.