Skip to main content
POST
Create Speech

Authorizations

Authorization
string
header
required

Enter your MeshAPI key (rsk_...) or, for the admin-keys endpoints, a dashboard session token — sent as Authorization: Bearer <token>.

Headers

X-Mesh-Version
enum<string>
default:2026-08

Dated version of the API contract to pin this request to. Omit it and the request is served under 2026-08 — the oldest supported version, so an existing integration is never moved by a release. A malformed or unsupported value is rejected with 400 invalid_api_version rather than falling back silently. The version actually served is echoed as X-Mesh-Version on every response, including errors.

Available options:
2026-08,
2026-09,
2026-11

Body

application/json
input
string
required
model
string
default:eleven_flash_v2_5
voice
string | null
stream
boolean
default:true
response_format
string | null
language_code
string | null
voice_settings
VoiceSettings · object | null
pronunciation_dictionary_locators
PronunciationDictionaryLocator · object[] | null
seed
integer | null
previous_text
string | null
next_text
string | null
previous_request_ids
string[] | null
next_request_ids
string[] | null
apply_text_normalization
string | null
apply_language_text_normalization
boolean | null
use_pvc_as_ivc
boolean | null
enable_logging
boolean | null
optimize_streaming_latency
integer | null
speaker
string
default:anushka
target_language_code
string
default:hi-IN
pitch
number | null
pace
number | null
loudness
number | null
speech_sample_rate
integer | null

Output sample rate in Hz. Honoured on Sarvam-, Runware- and SiliconFlow-served models, and accepted but ignored on the others. Each model publishes its own accepted rates, and some accept fewer depending on response_format; Mesh forwards your value as sent and never substitutes a supported rate for one a model does not accept. It applies to the model you named: if your request is served by a fallback instead — which X-Mesh-Routing-Fallback: true on the response tells you — the rate is not applied, because the fallback may accept a different set.

enable_preprocessing
boolean | null
speed
number | null

Speaking rate, where 1.0 is the voice's natural pace. Honoured on DeepInfra-, SiliconFlow- and Venice-served models and on Novita's MiniMax speech models, and accepted but ignored on the others — Novita's Fish Audio model reads no rate control at all, and on ElevenLabs the rate control is voice_settings.speed instead, with this endpoint's default model being an ElevenLabs one. A model's own accepted range may be narrower than the one allowed here; Mesh forwards your value as sent and never clamps it.

Required range: 0.25 <= x <= 4
vol
number | null
Required range: 0 < x <= 10
emotion
enum<string> | null
Available options:
happy,
sad,
angry,
fearful,
disgusted,
surprised,
calm,
fluent,
whisper
provider
string | null

Pin this request to one upstream provider, e.g. elevenlabs. The request is served by that provider or refused — never routed elsewhere. See GET /v1/providers/pinnable for the slugs this deployment accepts.

tags
Tags · object | null

Your own labels for this request, echoed back on the usage row and available as a filter and a group-by dimension in the usage API. String keys to string values. Never put personal or sensitive data here — tags are stored with the usage record and are not redacted.

Example:
safety_identifier
string | null

A stable, anonymised identifier for the end user making this request, recorded on the usage row and available as a filter and a group-by dimension in the usage API. Supersedes the deprecated user field. Use an opaque id, not an email address or a name.

Maximum string length: 256

Response

Successful Response