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:

https://api.suonora.com/v1

Authentication

All API requests require authentication using an API key. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Keep your API key secure and never share it publicly. You can find your API key in the Suonora Dashboard.

Available Endpoints

Response Format

All API responses are returned in JSON format. A successful response includes:

{
  "success": true,
  "data": {
    // Response data here
  }
}

Error responses follow this format:

{
  "success": false,
  "message": "Error description"
}

Rate Limits

Rate limits are based on your subscription plan:

PlanRequests per MinuteConcurrent Jobs
Personal601
Superior1202
Pro3005

Rate limits are enforced per API key. Consider upgrading your plan if you need higher limits.

Best Practices

  1. Error Handling

    • Always check the success field in responses
    • Implement proper error handling for all API calls
    • Use appropriate HTTP status codes
  2. Performance

    • Cache voice lists when possible
    • Implement retry logic with exponential backoff
    • Monitor your rate limit usage
  3. Security

    • Keep your API key secure
    • Use HTTPS for all requests
    • Rotate API keys periodically

Need Help?

If you need assistance, please:

  1. Contact our support team at support@suonora.com
  2. Visit our Documentation for detailed guides