API ReferenceMultimodal

Text to speech

Convert text to speech through the Respan gateway with automatic logging.

Headers

AuthorizationstringRequired

Bearer token. Use Bearer YOUR_API_KEY.

Request

This endpoint expects an object.
modelenumRequired
TTS model.
Allowed values:
inputstringRequired
Text to generate audio for. Max 4096 characters.
voiceenumRequired
Voice to use.
response_formatenumOptionalDefaults to mp3
Audio output format.
speeddoubleOptionalDefaults to 1

Audio speed (0.25 to 4.0).

customer_credentialsobjectOptional

Per-customer LLM provider credentials.

disable_logbooleanOptionalDefaults to false

When true, omits input/output from the log. Metrics still recorded.

metadataobjectOptional

Custom key-value metadata.

customer_identifierstringOptional
End user identifier.
customer_emailstringOptional
Customer email address.
thread_identifierstringOptional
Conversation thread ID.
request_breakdownbooleanOptional
Return response metrics summary in the response body.

Response

Audio content in the requested format.

Errors

401
Unauthorized Error