Text to speech

Convert text to speech with automatic language detection.

Request Body:

• text: Input text to convert to speech - required
• language: Language code (default: “auto”) - “auto” for automatic detection, or ISO 639-1 codes: en, zh, hi, es, ar, bn, pt, ru, ja, pa, de, ko, fr, tr, it, th, pl, nl, id, vi, ur
• model: TTS model identifier (default: “auto”) - “auto” selects the default provider; a registry-resolvable id dispatches to the matching provider

Response: Returns audio file in WAV format with X-Language-Code header

POST /api/v1/llm/speech/tts

Python (SDK)

Python

from mka1 import SDK


with SDK(
    bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:

    res = sdk.llm.speech.speak(text="Hello, welcome to our text-to-speech service.", language="en", model="auto")

    # Handle response
    print(res)

200

"(binary)"

Authorizations

Authorization · string · header · required

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Headers

X-On-Behalf-Of · string

Optional external end-user identifier forwarded by the API gateway.

Body

application/json

Request parameters for text-to-speech conversion with language selection.

text · string · required

Input text to convert to speech

Minimum string length: 1

language · enum<string> · default: auto

Language code: 'auto' for automatic detection, or ISO 639-1 language codes

Available options: auto, en, zh, hi, es, ar, bn, pt, ru, ja, pa, de, ko, fr, tr, it, th, pl, nl, id, vi, ur

model · string · default: auto

TTS model identifier. Defaults to 'auto', which selects the default provider. Registry-resolvable ids dispatch to the matching provider.

Example:

"auto"

Response

200 - audio/wav

Audio file in WAV format with language code header

The response is of type file.