Imole Premium TTS · Model docs

Audio

Premium TTS technical docs

Endpoint, auth header, parameters, prices, and tested request examples for Imole Premium TTS.

Endpoint

Endpoint and pricing

POST /audio/speech Endpoint https://api.imole.app/v1 Base URL 50 API cauris 50 Agent cauris

Headers

Request headers

Authorization required

Bearer Imole API key.

Content-Type required

Use application/json for JSON requests.

Parameters

Request parameters

model required

Use imole-premium-tts.

text

Primary narration text.

input

Alias of text.

references

Optional reference list for guided speech.

reference_audio_url

Reference audio URL.

reference_audio_base64

Reference audio as base64.

reference_text

Transcript of the reference audio.

temperature

Creativity control.

top_k

Top-k sampling control.

max_new_tokens

Maximum generated tokens in the speech model.

output_format

Audio output format.

mp3, wav

Examples

Tested request examples

Basic narration

curl -X POST "https://api.imole.app/v1/audio/speech" \
  -H "Authorization: Bearer $IMOLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "imole-premium-tts",
  "text": "Bonjour. Bienvenue sur Imole.",
  "output_format": "mp3",
  "temperature": 0.8
}'

Reference-guided narration

curl -X POST "https://api.imole.app/v1/audio/speech" \
  -H "Authorization: Bearer $IMOLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "imole-premium-tts",
  "text": "Bonjour. Cette narration suit la couleur de la voix de reference.",
  "reference_audio_url": "https://imole.app/docs-samples/reference.mp3",
  "reference_text": "Bonjour. Ceci est un sample audio Imole pour la documentation technique.",
  "output_format": "mp3"
}'

Check job status

curl -H "Authorization: Bearer $IMOLE_API_KEY" "https://api.imole.app/v1/audio/jobs/$JOB_ID"

Download result

curl -L -H "Authorization: Bearer $IMOLE_API_KEY" "https://api.imole.app/v1/audio/jobs/$JOB_ID/content" -o imole-premium-tts.mp3