Speech-02-Turbo

Run it

The smallest request that works: the required fields only.

curl https://api.percify.io/v3/playground/v1/run \
  -H "Authorization: Bearer $PERCIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "modelId": "speech-02-turbo",
    "input": {
      "text": "Speech-02-series is a Text-to-Audio and voice cloning technology that offers voice synt..."
    }
  }'

1. EstimatePOST /estimate with the same body returns the price and charges nothing.
2. RunPOST /run returns an id at once, with status processing.
3. CollectGET /generations/{id}?wait=55 returns the file URLs, or pass a webhook.

Parameters

13 fields in input, required first.

• textRequired
  string

  Text to narrate (max 10,000 characters). Use markers like <#0.5#> to insert pauses in seconds.

• voice_idOptional
  stringDefault English_Wiselady

  Voice to synthesize. Pick any system voice (e.g. English_Wiselady, English_Deep-VoicedGentleman) or a voice_id returned by See the full list of voices in the README.

• speedOptional
  numberDefault 1

  Speech speed multiplier (0.5, 2.0). Lower is slower, higher is faster.

• volumeOptional
  numberDefault 1

  Relative loudness. 1.0 is default gain. Range 0, 10.

• pitchOptional
  integerDefault 0

  Semitone offset applied to the voice (−12 to +12).

• emotionOptional
  auto, happy, sad, angry, fearful, disgusted, surprised, calm, fluent, neutralDefault auto

  Desired delivery style. Use auto to let choose, or pick a specific emotion.

• english_normalizationOptional
  booleanDefault false

  Improve number/date reading for English text (adds a small amount of latency).

• sample_rateOptional
  8000, 16000, 22050, 24000, 32000, 44100Default 32000

  Audio sample rate in Hz.

• bitrateOptional
  32000, 64000, 128000, 256000Default 128000

  MP3 bitrate in bits per second. Only used when audio_format is mp3.

• audio_formatOptional
  mp3, wav, flac, pcmDefault mp3

  File format for the generated audio. Choose mp3 for general use, wav/flac for lossless, or pcm for raw bytes.

• channelOptional
  mono, stereoDefault mono

  mono for 1 channel (default), stereo for 2 channels.

• subtitle_enableOptional
  booleanDefault false

  Return subtitle metadata with sentence timestamps (non-streaming only).

• language_boostOptional
  None, Automatic, Chinese, Chinese,Yue, Cantonese, English, Arabic, Russian, Spanish, French, Portuguese, German, Turkish, Dutch, Ukrainian, Vietnamese, Indonesian, Japanese, Italian, Korean, Thai, Polish, Romanian, Greek, Czech, Finnish, Hindi, Bulgarian, Danish, Hebrew, Malay, Persian, Slovak, Swedish, Croatian, Filipino, Hungarian, Norwegian, Slovenian, Catalan, Nynorsk, Tamil, AfrikaansDefault None

  Optional language hint. Choose Automatic to let detect the language, or pick a specific locale.