Introduction
Learn about Suonora’s API endpoints, authentication, base URL, and available operations.
Introduction
Welcome to the Suonora API documentation. This guide will help you get started with our text-to-speech API.
Base URL
All API requests should be made to:
Authentication
All API requests require authentication using an API key. Include your API key in the Authorization
header:
Keep your API key secure and never share it publicly. You can find your API key in the Suonora Dashboard.
Available Endpoints
Speech API
Convert text to speech and generate high-quality audio files.
Streaming API
Stream audio in real-time for immediate playback.
Voices API
List available voices and their characteristics.
Balance API
Check your account balance and usage statistics.
Response Format
All API responses are returned in JSON format. A successful response includes:
Error responses follow this format:
Rate Limits
Rate limits are based on your subscription plan:
Plan | Requests per Minute | Concurrent Jobs |
---|---|---|
Personal | 60 | 1 |
Superior | 120 | 2 |
Pro | 300 | 5 |
Rate limits are enforced per API key. Consider upgrading your plan if you need higher limits.
Best Practices
-
Error Handling
- Always check the
success
field in responses - Implement proper error handling for all API calls
- Use appropriate HTTP status codes
- Always check the
-
Performance
- Cache voice lists when possible
- Implement retry logic with exponential backoff
- Monitor your rate limit usage
-
Security
- Keep your API key secure
- Use HTTPS for all requests
- Rotate API keys periodically
Need Help?
If you need assistance, please:
- Contact our support team at support@suonora.com
- Visit our Documentation for detailed guides