Frequently Asked Questions
We’ve compiled frequently asked questions and their answers during API usage.
1. Get Started with API
Where can I get an API Key?
Where can I get an API Key?
How do I integrate the API?
How do I integrate the API?
x-sup-api-key header. For detailed integration methods, please refer to Quick Start.Do I need to use a different account from Play?
Do I need to use a different account from Play?
2. Voice & API Calls
Where can I check available voice IDs?
Where can I check available voice IDs?
- 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.
Can I use cloned voices in the API?
Can I use cloned voices in the API?
How can I find the ID of a cloned voice?
How can I find the ID of a cloned voice?
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.Can I make calls just knowing the voice ID?
Can I make calls just knowing the voice ID?
voice_id, the language, style, and model combination must match exactly for voice to be generated normally.What combinations are possible for each voice?
What combinations are possible for each voice?
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.Is the style parameter required?
Is the style parameter required?
Can I adjust voice speed or pitch?
Can I adjust voice speed or pitch?
pitch_shift, pitch_variance, and speed through voice_settings.What is the Predict Duration API for?
What is the Predict Duration API for?
3. Credit & Pricing
What is the API pricing plan?
What is the API pricing plan?
How can I check my credit balance?
How can I check my credit balance?
- Call
GET /v1/creditsAPI - Check console or Play dashboard
Are credits only deducted from the API?
Are credits only deducted from the API?
Can I use voices created in Play in the API?
Can I use voices created in Play in the API?
4. Errors & Troubleshooting
What are the most common errors when making calls?
What are the most common errors when making calls?
- 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.
Where can I check error codes?
Where can I check error codes?
My calls keep failing.
My calls keep failing.
- 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.
What are the call frequency limits?
What are the call frequency limits?
🏢 Enterprise Inquiry
5. Operational Policy & Support
Can anyone use the API?
Can anyone use the API?
Is there an enterprise plan?
Is there an enterprise plan?
🏢 Enterprise Inquiry
Where do I contact if problems aren't resolved?
Where do I contact if problems aren't resolved?