{"openapi":"3.1.0","info":{"title":"Self-hosted Multilingual Preset TTS API","description":"Self-hosted TTS API with real per-language routing. It never returns wrong-language fallback audio by default.","version":"0.3.0"},"paths":{"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/voices":{"get":{"summary":"Voices","operationId":"voices_v1_voices_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VoiceCatalog"}}}}}}},"/v1/audio/speech":{"post":{"summary":"Synthesize","operationId":"synthesize_v1_audio_speech_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SynthesisRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SynthesisResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/synthesize":{"post":{"summary":"Synthesize","operationId":"synthesize_synthesize_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SynthesisRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SynthesisResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/audio/{job_id}":{"get":{"summary":"Get Audio","operationId":"get_audio_v1_audio__job_id__get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"SynthesisRequest":{"properties":{"text":{"type":"string","minLength":1,"title":"Text"},"language":{"type":"string","title":"Language","description":"Requested language code, e.g. bn, en, es, hi.","default":"bn"},"gender":{"type":"string","enum":["auto","female","male","neutral"],"title":"Gender","description":"Requested voice gender. Gender can fall back only within the same language.","default":"auto"},"preset":{"anyOf":[{"type":"string","enum":["neutral","warm","professional","calm","urgent","apologetic","excited","soft"]},{"type":"null"}],"title":"Preset"},"tone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tone"},"voice":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Voice"},"speed":{"anyOf":[{"type":"number","maximum":2.0,"minimum":0.5},{"type":"null"}],"title":"Speed"},"response_format":{"type":"string","const":"wav","title":"Response Format","default":"wav"}},"type":"object","required":["text"],"title":"SynthesisRequest"},"SynthesisResponse":{"properties":{"id":{"type":"string","title":"Id"},"engine":{"type":"string","title":"Engine"},"backend":{"type":"string","title":"Backend"},"model":{"type":"string","title":"Model"},"language_requested":{"type":"string","title":"Language Requested"},"language_applied":{"type":"string","title":"Language Applied"},"language_name":{"type":"string","title":"Language Name"},"gender_requested":{"type":"string","title":"Gender Requested"},"gender_applied":{"type":"string","title":"Gender Applied"},"voice_requested":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Voice Requested"},"voice_applied":{"type":"string","title":"Voice Applied"},"tone_requested":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tone Requested"},"preset_requested":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preset Requested"},"preset_applied":{"type":"string","title":"Preset Applied"},"style_capability":{"type":"string","enum":["native_emotion","voice_style","audio_preset","unavailable"],"title":"Style Capability"},"tone_applied":{"type":"string","enum":["native","approximate","not_available"],"title":"Tone Applied"},"fallback_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fallback Reason"},"audio_url":{"type":"string","title":"Audio Url"},"elapsed_seconds":{"type":"number","title":"Elapsed Seconds"},"text_sha256":{"type":"string","title":"Text Sha256"},"audio_params":{"type":"object","title":"Audio Params"}},"type":"object","required":["id","engine","backend","model","language_requested","language_applied","language_name","gender_requested","gender_applied","voice_requested","voice_applied","tone_requested","preset_requested","preset_applied","style_capability","tone_applied","fallback_reason","audio_url","elapsed_seconds","text_sha256","audio_params"],"title":"SynthesisResponse"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VoiceCatalog":{"properties":{"total_languages_advertised":{"type":"integer","title":"Total Languages Advertised"},"installed_languages":{"items":{"type":"string"},"type":"array","title":"Installed Languages"},"validated_languages":{"items":{"type":"string"},"type":"array","title":"Validated Languages"},"presets":{"type":"object","title":"Presets"},"voices":{"items":{"type":"object"},"type":"array","title":"Voices"},"truth_note":{"type":"string","title":"Truth Note"}},"type":"object","required":["total_languages_advertised","installed_languages","validated_languages","presets","voices","truth_note"],"title":"VoiceCatalog"}}}}