メインコンテンツへスキップ
POST
Text-to-Speech (Bytes)

承認

Authorization
string
header
デフォルト:$CARTESIA_API_KEY
必須

Cartesia API key (sk_car_...). Get one at play.cartesia.ai/keys.

ヘッダー

Cartesia-Version
enum<string>
デフォルト:2026-03-01
必須

API version header.

利用可能なオプション:
2026-03-01
:

"2026-03-01"

ボディ

application/json
model_id
enum<string>
デフォルト:sonic-3.5
必須

The ID of the model to use for the generation. See Models all options.

利用可能なオプション:
sonic-3.5,
sonic-3,
sonic-latest
:

"sonic-3.5"

transcript
string
デフォルト:Hi there, it's awesome to meet you.
必須
voice
TTSRequestVoiceSpecifier · object
必須
output_format
WAVOutputFormat · object
必須
language
enum<string> | null

The language that the given voice should speak the transcript in. This may depend on the model you're using. See Models for details.

利用可能なオプション:
en,
fr,
de,
es,
pt,
zh,
ja,
hi,
it,
ko,
nl,
pl,
ru,
sv,
tr,
tl,
bg,
ro,
ar,
cs,
el,
fi,
hr,
ms,
sk,
da,
ta,
uk,
hu,
no,
vi,
bn,
th,
he,
ka,
id,
te,
gu,
kn,
ml,
mr,
pa
pronunciation_dict_id
string | null

The ID of a pronunciation dictionary to use for the generation. Pronunciation dictionaries are supported by sonic-3 models and newer.

generation_config
GenerationConfig · object

Configure the various attributes of the generated speech. Available on sonic-3 and sonic-3.5; not available on earlier models.

See Volume, Speed, and Emotion for a guide on this option.

speed
enum<string>
デフォルト:normal
非推奨

This property is deprecated and may not work for all voices. Use generation_config.speed instead. Influences the speed of the generated speech.

利用可能なオプション:
slow,
normal,
fast

レスポンス

200 - audio/*

Audio bytes

The response is of type file.