Skip to main content
POST
Generates audio from the input text.
Choose an exact compatible ID from the model list. Supported parameters and output formats vary by model and connection; this schema does not guarantee every upstream feature. See endpoint availability.

Authorizations

api-key
string
header
required

Your Hicap API key.

Headers

x-hicap-tags
string

One JSON object mapping dimension keys to short string values. Never include secrets or direct personal identifiers. Opaque identity references require approved policy and verified destination handling; see the identity attribution guide.

Body

application/json

Speech request.

input
string
required

Text to synthesize. Length limits depend on the selected model.

Minimum string length: 1
voice
string
required

A voice identifier supported by the selected model. Voice identifiers and availability are model-specific.

model
string
required

Exact compatible Hicap model ID from GET /v1/models.

Minimum string length: 1
response_format
string

A supported audio output format; available formats depend on the model.

speed
number
default:1

The speed of the synthesize audio. Select a value from 0.25 to 4.0. 1.0 is the default.

Required range: 0.25 <= x <= 4

Response

OK

The response is of type file.