テキスト読み上げ (Bytes) - Cartesia Docs

Text-to-Speech (Bytes)

curl --request POST \
  --url https://api.cartesia.ai/tts/bytes \
  --header 'Authorization: Bearer <token>' \
  --header 'Cartesia-Version: <cartesia-version>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "model_id": "sonic-3.6",
  "transcript": "Hi there, it's awesome to meet you.",
  "voice": "db6b0ed5-d5d3-463d-ae85-518a07d3c2b4",
  "output_format": {
    "container": "wav",
    "encoding": "pcm_s16le",
    "sample_rate": 44100
  },
  "language": "<string>",
  "locale": "<string>",
  "accent": "<string>",
  "normalization": "auto",
  "pronunciation_dict_id": "<string>",
  "generation_config": {
    "volume": 1,
    "speed": 1
  }
}
EOF

import requests

url = "https://api.cartesia.ai/tts/bytes"

payload = {
    "model_id": "sonic-3.6",
    "transcript": "Hi there, it's awesome to meet you.",
    "voice": "db6b0ed5-d5d3-463d-ae85-518a07d3c2b4",
    "output_format": {
        "container": "wav",
        "encoding": "pcm_s16le",
        "sample_rate": 44100
    },
    "language": "<string>",
    "locale": "<string>",
    "accent": "<string>",
    "normalization": "auto",
    "pronunciation_dict_id": "<string>",
    "generation_config": {
        "volume": 1,
        "speed": 1
    }
}
headers = {
    "Cartesia-Version": "<cartesia-version>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Cartesia-Version': '<cartesia-version>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_id: 'sonic-3.6',
    transcript: 'Hi there, it\'s awesome to meet you.',
    voice: 'db6b0ed5-d5d3-463d-ae85-518a07d3c2b4',
    output_format: {container: 'wav', encoding: 'pcm_s16le', sample_rate: 44100},
    language: '<string>',
    locale: '<string>',
    accent: '<string>',
    normalization: 'auto',
    pronunciation_dict_id: '<string>',
    generation_config: {volume: 1, speed: 1}
  })
};

fetch('https://api.cartesia.ai/tts/bytes', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cartesia.ai/tts/bytes",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model_id' => 'sonic-3.6',
    'transcript' => 'Hi there, it\'s awesome to meet you.',
    'voice' => 'db6b0ed5-d5d3-463d-ae85-518a07d3c2b4',
    'output_format' => [
        'container' => 'wav',
        'encoding' => 'pcm_s16le',
        'sample_rate' => 44100
    ],
    'language' => '<string>',
    'locale' => '<string>',
    'accent' => '<string>',
    'normalization' => 'auto',
    'pronunciation_dict_id' => '<string>',
    'generation_config' => [
        'volume' => 1,
        'speed' => 1
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Cartesia-Version: <cartesia-version>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cartesia.ai/tts/bytes"

	payload := strings.NewReader("{\n  \"model_id\": \"sonic-3.6\",\n  \"transcript\": \"Hi there, it's awesome to meet you.\",\n  \"voice\": \"db6b0ed5-d5d3-463d-ae85-518a07d3c2b4\",\n  \"output_format\": {\n    \"container\": \"wav\",\n    \"encoding\": \"pcm_s16le\",\n    \"sample_rate\": 44100\n  },\n  \"language\": \"<string>\",\n  \"locale\": \"<string>\",\n  \"accent\": \"<string>\",\n  \"normalization\": \"auto\",\n  \"pronunciation_dict_id\": \"<string>\",\n  \"generation_config\": {\n    \"volume\": 1,\n    \"speed\": 1\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Cartesia-Version", "<cartesia-version>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.cartesia.ai/tts/bytes")
  .header("Cartesia-Version", "<cartesia-version>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model_id\": \"sonic-3.6\",\n  \"transcript\": \"Hi there, it's awesome to meet you.\",\n  \"voice\": \"db6b0ed5-d5d3-463d-ae85-518a07d3c2b4\",\n  \"output_format\": {\n    \"container\": \"wav\",\n    \"encoding\": \"pcm_s16le\",\n    \"sample_rate\": 44100\n  },\n  \"language\": \"<string>\",\n  \"locale\": \"<string>\",\n  \"accent\": \"<string>\",\n  \"normalization\": \"auto\",\n  \"pronunciation_dict_id\": \"<string>\",\n  \"generation_config\": {\n    \"volume\": 1,\n    \"speed\": 1\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cartesia.ai/tts/bytes")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Cartesia-Version"] = '<cartesia-version>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model_id\": \"sonic-3.6\",\n  \"transcript\": \"Hi there, it's awesome to meet you.\",\n  \"voice\": \"db6b0ed5-d5d3-463d-ae85-518a07d3c2b4\",\n  \"output_format\": {\n    \"container\": \"wav\",\n    \"encoding\": \"pcm_s16le\",\n    \"sample_rate\": 44100\n  },\n  \"language\": \"<string>\",\n  \"locale\": \"<string>\",\n  \"accent\": \"<string>\",\n  \"normalization\": \"auto\",\n  \"pronunciation_dict_id\": \"<string>\",\n  \"generation_config\": {\n    \"volume\": 1,\n    \"speed\": 1\n  }\n}"

response = http.request(request)
puts response.read_body

"<string>"

POST

/

tts

/

bytes

Text-to-Speech (Bytes)

curl --request POST \
  --url https://api.cartesia.ai/tts/bytes \
  --header 'Authorization: Bearer <token>' \
  --header 'Cartesia-Version: <cartesia-version>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "model_id": "sonic-3.6",
  "transcript": "Hi there, it's awesome to meet you.",
  "voice": "db6b0ed5-d5d3-463d-ae85-518a07d3c2b4",
  "output_format": {
    "container": "wav",
    "encoding": "pcm_s16le",
    "sample_rate": 44100
  },
  "language": "<string>",
  "locale": "<string>",
  "accent": "<string>",
  "normalization": "auto",
  "pronunciation_dict_id": "<string>",
  "generation_config": {
    "volume": 1,
    "speed": 1
  }
}
EOF

import requests

url = "https://api.cartesia.ai/tts/bytes"

payload = {
    "model_id": "sonic-3.6",
    "transcript": "Hi there, it's awesome to meet you.",
    "voice": "db6b0ed5-d5d3-463d-ae85-518a07d3c2b4",
    "output_format": {
        "container": "wav",
        "encoding": "pcm_s16le",
        "sample_rate": 44100
    },
    "language": "<string>",
    "locale": "<string>",
    "accent": "<string>",
    "normalization": "auto",
    "pronunciation_dict_id": "<string>",
    "generation_config": {
        "volume": 1,
        "speed": 1
    }
}
headers = {
    "Cartesia-Version": "<cartesia-version>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Cartesia-Version': '<cartesia-version>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_id: 'sonic-3.6',
    transcript: 'Hi there, it\'s awesome to meet you.',
    voice: 'db6b0ed5-d5d3-463d-ae85-518a07d3c2b4',
    output_format: {container: 'wav', encoding: 'pcm_s16le', sample_rate: 44100},
    language: '<string>',
    locale: '<string>',
    accent: '<string>',
    normalization: 'auto',
    pronunciation_dict_id: '<string>',
    generation_config: {volume: 1, speed: 1}
  })
};

fetch('https://api.cartesia.ai/tts/bytes', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cartesia.ai/tts/bytes",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model_id' => 'sonic-3.6',
    'transcript' => 'Hi there, it\'s awesome to meet you.',
    'voice' => 'db6b0ed5-d5d3-463d-ae85-518a07d3c2b4',
    'output_format' => [
        'container' => 'wav',
        'encoding' => 'pcm_s16le',
        'sample_rate' => 44100
    ],
    'language' => '<string>',
    'locale' => '<string>',
    'accent' => '<string>',
    'normalization' => 'auto',
    'pronunciation_dict_id' => '<string>',
    'generation_config' => [
        'volume' => 1,
        'speed' => 1
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Cartesia-Version: <cartesia-version>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cartesia.ai/tts/bytes"

	payload := strings.NewReader("{\n  \"model_id\": \"sonic-3.6\",\n  \"transcript\": \"Hi there, it's awesome to meet you.\",\n  \"voice\": \"db6b0ed5-d5d3-463d-ae85-518a07d3c2b4\",\n  \"output_format\": {\n    \"container\": \"wav\",\n    \"encoding\": \"pcm_s16le\",\n    \"sample_rate\": 44100\n  },\n  \"language\": \"<string>\",\n  \"locale\": \"<string>\",\n  \"accent\": \"<string>\",\n  \"normalization\": \"auto\",\n  \"pronunciation_dict_id\": \"<string>\",\n  \"generation_config\": {\n    \"volume\": 1,\n    \"speed\": 1\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Cartesia-Version", "<cartesia-version>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.cartesia.ai/tts/bytes")
  .header("Cartesia-Version", "<cartesia-version>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model_id\": \"sonic-3.6\",\n  \"transcript\": \"Hi there, it's awesome to meet you.\",\n  \"voice\": \"db6b0ed5-d5d3-463d-ae85-518a07d3c2b4\",\n  \"output_format\": {\n    \"container\": \"wav\",\n    \"encoding\": \"pcm_s16le\",\n    \"sample_rate\": 44100\n  },\n  \"language\": \"<string>\",\n  \"locale\": \"<string>\",\n  \"accent\": \"<string>\",\n  \"normalization\": \"auto\",\n  \"pronunciation_dict_id\": \"<string>\",\n  \"generation_config\": {\n    \"volume\": 1,\n    \"speed\": 1\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cartesia.ai/tts/bytes")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Cartesia-Version"] = '<cartesia-version>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model_id\": \"sonic-3.6\",\n  \"transcript\": \"Hi there, it's awesome to meet you.\",\n  \"voice\": \"db6b0ed5-d5d3-463d-ae85-518a07d3c2b4\",\n  \"output_format\": {\n    \"container\": \"wav\",\n    \"encoding\": \"pcm_s16le\",\n    \"sample_rate\": 44100\n  },\n  \"language\": \"<string>\",\n  \"locale\": \"<string>\",\n  \"accent\": \"<string>\",\n  \"normalization\": \"auto\",\n  \"pronunciation_dict_id\": \"<string>\",\n  \"generation_config\": {\n    \"volume\": 1,\n    \"speed\": 1\n  }\n}"

response = http.request(request)
puts response.read_body

"<string>"

承認

Authorization

string

header

デフォルト:$CARTESIA_API_KEY

必須

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

ヘッダー

Cartesia-Version

enum<string>

デフォルト:2026-08-14

必須

API version header.

利用可能なオプション:

2026-08-14

例:

"2026-08-14"

ボディ

application/json

model_id

enum<string>

デフォルト:sonic-3.6

必須

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

利用可能なオプション:

sonic-3.6,

sonic-3.5,

sonic-3,

sonic-latest

例:

"sonic-3.6"

transcript

string

デフォルト:Hi there, it's awesome to meet you.

必須

voice

必須

The ID of the voice.

例:

"db6b0ed5-d5d3-463d-ae85-518a07d3c2b4"

output_format

WAVOutputFormat · object

必須

WAVOutputFormat
MP3OutputFormat
RAWOutputFormat

Show child attributes

language

string | null

The transcript's language or locale (for example en or en-GB). language and locale accept the same values. Set one or the other, never both; setting both returns a 400 error. See supported codes.

locale

string | null

The transcript's language or locale (for example en or en-GB). locale and language accept the same values. Set one or the other, never both; setting both returns a 400 error. See supported codes.

accent

string | null

Usually unnecessary: Cartesia picks the closest accent the voice supports for the requested language or locale. Set it only to make a multilingual voice sound accented (e.g. speak English with a French accent). Must come from the voice's Get Voice accents field. Learn more here.

normalization

string | null

デフォルト:auto

Text normalization. auto (default) runs the locale-aware normalizer, off skips it, or pass a language or locale code (for example en or en-IN) to pin the normalizer independently of the generation language. See Text Normalization.

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 newer models; not available on earlier models.

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

Show child attributes

レスポンス

200 - audio/*

Audio bytes

The response is of type file.