Developers / Text to Speech

List available voices

GET https://api.echonova.ai/v1/text-to-speech/voices

Lists the EchoNova voice library. Send a voice's id as voiceId when you generate speech.

Headers

Authorization string Required

Bearer, a space, then your API key, which starts with ek_. Create keys in the portal under Developers, API Keys.

Response

200 application/json Every response uses this envelope.

data object

The result.

success boolean

true for a successful call.

statusCode integer

Repeats the HTTP status.

errorMessage string or null

null on success.

Errors

Same envelope, with success false and data null. All errors

GET /v1/text-to-speech/voices

curl "https://api.echonova.ai/v1/text-to-speech/voices" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": {
    "items": [
      {
        "id": "66e5ef3a9c1d2b4f8a7e6c01",
        "name": "ae_ahmed",
        "displayName": "Ahmed",
        "language": "ar",
        "gender": "Male",
        "previewUrl": "https://storage.example.com/voices/ae_ahmed-preview.wav"
      }
    ],
    "total": 1
  },
  "success": true,
  "statusCode": 200,
  "errorMessage": null
}