Text to Speech

Convert text to speech

post

Convert text to speech using a specified voice. Supports emotion control, speed adjustment, and multiple output formats.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

Body

multipart/form-data

textstringRequired

Text to convert (max 5000 chars)

voice_idstringOptional

Voice ID to use for synthesis

filestring · binaryOptional

Audio file for voice cloning (alternative to voice_id)

quality_presetintegerOptional

Quality preset for synthesis

Default: 3

output_formatstring · enumOptional

Output audio format (wav/mp3)

Default: wavPossible values:

speednumberOptional

Speech speed multiplier

Default: 1

durationnumberOptional

Target audio duration in seconds

Default: 0

target_langstringOptional

Target language code (e.g., "zh", "en", "zh+en")

similarity_enhbooleanOptional

Whether to enhance voice similarity

Default: false

emostringOptional

Emotion parameters as JSON string, e.g., {"Sadness":0.2, "Surprise":0.5}

trim_silencebooleanOptional

Whether to trim leading and trailing silence from the generated audio

Default: false

save_voicebooleanOptional

Whether to save the uploaded voice file

Default: false

Responses

200

Success — returns audio binary stream

audio/wavaudio/mpeg

Responsestring · binary

400

Invalid parameters or processing error

application/json

401

API Key missing or invalid

application/json

402

Payment required

application/json

500

Internal server error (TTS synthesis failure)

application/json

post

/text-to-speech

HTTP - BasicHTTP - With emotion

POST /v1/text-to-speech HTTP/1.1
Host: noiz.ai
Authorization: YOUR_API_KEY
Content-Type: multipart/form-data

text=Hello, how are you?&voice_id=abc123

binary

Emotion enhancement

post

Automatically add emotion annotations to input text. The enhanced text can be used directly in the text-to-speech API for more expressive speech synthesis.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

Body

application/json

textstringRequired

Text to enhance with emotions (max 5000 chars)

Responses

200

Success

application/json

codeintegerOptional

Status code (0 = success)

messagestringOptional

400

Invalid request

application/json

401

API Key missing or invalid

application/json

402

Payment required

application/json

429

Hard limit exceeded

application/json

post

/emotion-enhance

HTTP

POST /v1/emotion-enhance HTTP/1.1
Host: noiz.ai
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*

{
  "text": "Hello, how are you today? I'm so excited to see you!"
}

{
  "code": 0,
  "message": "success",
  "data": {
    "emotion_enhance": "[Happy#Joy:0.8;Excitement:0.2]:Hello, how are you today? I'm so excited to see you!"
  }
}