Suonora API Documentation

1. Introduction

Welcome to the Suonora API documentation. This guide shows you how to integrate Suonora’s text‑to‑speech (TTS) service into your application.

What this documentation covers

• Base URL for API requests
• Authentication requirements
• Concurrency limits per subscription plan
• Endpoints for listing voices, checking balance, and generating speech
• Required parameters for API calls
• Response formats and error codes

Base URL

https://api.suonora.com/v1

Authentication

Every request must include an API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Generate and manage your keys from the Suonora Developer Dashboard.

Concurrency Limits

Suonora limits how many TTS jobs you can have in progress at the same time. Extra requests are queued automatically until a slot is free.

If the internal queue is full you may receive a 429 Too Many Requests or 503 Service Unavailable. Retrying with exponential back‑off is recommended.

Example Request & Response

Request

curl -X GET "https://api.suonora.com/v1/voices/list" \
     -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "success": true,
  "voices": [
    {
      "id": "axel",
      "name": "Axel",
      "gender": "Male",
      "locale": "de-DE",
      "mp3_preview": "https://storage.googleapis.com/suonora-public/voices/Axel.mp3"
    }
  ]
}