FAQ
Find answers to common questions about using Supertone API.
Customer Support
Customer Support
Send us an email with your questions or concerns, and we’ll respond as quickly as possible.
Technical Inquiries
You can receive an API key after applying for closed beta access on the console page and getting approved. You can have up to 3 API keys at once, and each key expires after 2 years from the issue date. Please check the expiration date and request a new key when needed.
The most common issues are API key authentication failures, incorrect parameters, and exceeding usage limits. You can identify the specific cause by checking the status codes.
API Usage and Request Limits
You can make up to 20 calls per minute. Exceeding this limit may result in slower response times or errors.
You can process up to 200 characters at once (including spaces), and you cannot make API calls with only spaces or punctuation marks.
Yes, that’s possible. However, sending too many requests simultaneously may result in slower processing times.
You can check the length of generated voice content for a specific period by calling the Get Voice Usage API. For more details, please refer to the API reference documentation.
Supertone Voice Testing
Yes, you can sign up for Supertone Play and test all voices for free for 2 weeks. After testing, you can copy the ID and settings of the voices you like and use them directly in API calls.
Create content in Supertone Play by applying various voices and detailed settings, then copy the detailed settings of the line you like. You can copy your ID and voice settings by clicking the button in the upper right corner of the line panel on the right side of the screen.
The 2-week free trial period for Supertone Play cannot be extended. After the trial period expires, you’ll need to switch to the API service.
Voice Quality and Features
We currently support Korean (ko), Japanese (ja), and English (en), with optimized voice models for each language.
Currently, each voice comes with default emotions and tones. You can adjust the pitch, pitch range, and speech rate. For more details, please refer to the API reference documentation.
Integration and Implementation
Since we provide a REST API, you can use any programming language that can make HTTP requests.
Yes, you can call the API using JavaScript in browser environments. CORS is configured to allow client-side implementation.
Security and Privacy
Immediately revoke the exposed API key on the console page and generate a new one.
Yes, all API communications are encrypted via HTTPS.
They may be stored for a certain period to improve service quality. For more details, please refer to Supertone’s Privacy Policy.
Pricing and Payment
During the closed beta period, you will be charged $0.1 per minute of generated voice content.
Billing is done in arrears, and invoices are sent to your registered email on the 15th and last day of each month.
Payment must be completed within 5 days of receiving the invoice. Service may be suspended if payment is delayed beyond this period.
Once you pay the outstanding amount, your service will be restored after confirmation by our staff.
Partial minutes are not charged. For example, if you generate 1 minute and 30 seconds of voice content, you will only be charged for 1 minute.
You can check real-time usage and estimated charges on the dashboard in the console page. Detailed statements are available in the invoices sent to your email.
Currently, we only support credit card payments. We plan to add more payment options in the future.
Yes, Supertone API service is available worldwide. Charges are billed in USD and can be paid with any credit card that supports international transactions.
To receive tax invoices, you need to subscribe to our separate Enterprise plan. For Enterprise plan inquiries, please submit your request here.