textstringОбязательноПередайте обязательный сценарий длиной до 10 000 символов. Подсказки вроде [whispers] размещайте у нужных слов; перед большой серией генераций вычитайте текст.
- По умолчанию
- Не задано
- Ограничения
- minLength:1maxLength:10000
elevenlabs/v4-turbo/text-to-speechElevenLabs v4 Turbo озвучивает сценарий одним голосом с помощью модели ElevenLabs, ориентированной на задержку. Выберите из 21 готового голоса и получите запись через результат задачи.
Примеры используют публичные параметры выбранного эндпоинта. Замените API-ключ и примеры медиафайлов, затем отправьте запрос со своего сервера.
SDK и интеграцииhttps://api.spicyapi.ai/api/v1/jobs/createTaskХраните API-ключ в серверной переменной окружения SPICY_API_KEY. Используйте Bearer-аутентификацию и Content-Type: application/json для JSON-запросов.
Authorization: Bearer $SPICY_API_KEY# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "elevenlabs/v4-turbo/text-to-speech",
"input": {
"text": "Welcome back. Your files finished rendering a minute ago and are ready to download.",
"language": "auto",
"voice_id": "Roger",
"output_format": "mp3_44100_128",
"text_normalization_mode": "auto"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"Пример построен по входной схеме этой модели — той же, по которой API проверяет каждый запрос.
Поместите эти поля в объект input тела запроса. Имена и типы соответствуют API. Не предполагайте значение по умолчанию, если оно не задано.
textstringОбязательноПередайте обязательный сценарий длиной до 10 000 символов. Подсказки вроде [whispers] размещайте у нужных слов; перед большой серией генераций вычитайте текст.
seedintegerНеобязательноФиксируйте seed, чтобы сравнивать по одному изменению сценария или настройки. Воспринимайте результат как новое исполнение, без ожидания идентичного аудио.
clone_strengthnumberНеобязательноИсключите clone_strength из экспериментов с готовыми голосами: он на них не действует. Выбор собственного или клонированного голоса этим эндпоинтом не предусмотрен.
text_normalization_modestringНеобязательноИспользуйте auto, on или off для нормализации чисел и сокращений. Проверяйте именно те даты, названия продуктов и коды, которые планируете публиковать: буквенная запись не всегда даёт нужное звучание.
"auto""on""off"output_formatstringНеобязательноВыберите один из 9 вариантов; по умолчанию задан mp3_44100_128, другой вариант MP3 — mp3_22050_32. Убедитесь, что среда воспроизведения принимает выбранный формат.
"mp3_44100_128""mp3_44100_64""mp3_22050_32""opus_48000_128""pcm_24000""pcm_16000""wav_44100""ulaw_8000""alaw_8000"similarity_boostnumberНеобязательноМеняйте similarity_boost при оценке следования выбранному голосу. Сравнивайте на одинаковых словах и не изменяйте несколько голосовых настроек одновременно.
stabilitynumberНеобязательноНастройте ровность подачи через stability и прослушайте короткий пример. Сравнивая значения, оставляйте сценарий и голос прежними; совпадения дублей не гарантирует ни одно значение.
languagestringНеобязательноДоступны auto и 91 поддерживаемый код языка. Для короткой локализованной подсказки задайте нужный язык и передайте уже написанный на нём текст.
"auto""af""am""ar""hy""as""ast""az""be""bn""bs""bg""my""yue""ca""ceb""hr""cs""da""nl""en""et""fil""fi""fr""ff""gl""ka""de""el""gu""ha""he""hi""hu""is""id""it""ja""jv""kam""kn""kk""ko""ky""lo""lv""ln""lt""lg""lb""mk""ms""ml""mt""zh""mi""mr""mn""ne""no""oc""or""ps""fa""pl""pt""pa""ro""ru""sr""sn""sd""sk""sl""so""ckb""es""sw""sv""tg""ta""te""th""tr""uk""ur""uz""vi""cy""wo""zu"voice_idstringНеобязательноУкажите один из 21 готового голоса; без выбора используется Roger. Сравните Sarah, Daniel и Lily на одной короткой реплике вместо передачи собственного идентификатора голоса.
"Adam""Alice""Bella""Bill""Brian""Callum""Charlie""Chris""Daniel""Eric""George""Harry""Jessica""Laura""Liam""Lily""Matilda""River""Roger""Sarah""Will"{
"type": "object",
"required": [
"text"
],
"x-pricing": {
"billingMode": "per_unit",
"variantFields": []
},
"properties": {
"seed": {
"type": "integer",
"x-ui": {
"order": 10,
"widget": "number",
"advanced": true
},
"maximum": 4294967295,
"minimum": 0,
"description": "Random seed for controlled comparisons."
},
"text": {
"type": "string",
"x-ui": {
"rows": 6,
"order": 100,
"widget": "textarea",
"primary": true
},
"maxLength": 10000,
"minLength": 1,
"description": "The words to speak. Audio tags such as [whispers] or [sighs] are performed, not read. Billed per 1,000 characters. Up to 10,000 characters; about 5,000 or fewer keeps a long read from being cut off."
},
"language": {
"enum": [
"auto",
"af",
"am",
"ar",
"hy",
"as",
"ast",
"az",
"be",
"bn",
"bs",
"bg",
"my",
"yue",
"ca",
"ceb",
"hr",
"cs",
"da",
"nl",
"en",
"et",
"fil",
"fi",
"fr",
"ff",
"gl",
"ka",
"de",
"el",
"gu",
"ha",
"he",
"hi",
"hu",
"is",
"id",
"it",
"ja",
"jv",
"kam",
"kn",
"kk",
"ko",
"ky",
"lo",
"lv",
"ln",
"lt",
"lg",
"lb",
"mk",
"ms",
"ml",
"mt",
"zh",
"mi",
"mr",
"mn",
"ne",
"no",
"oc",
"or",
"ps",
"fa",
"pl",
"pt",
"pa",
"ro",
"ru",
"sr",
"sn",
"sd",
"sk",
"sl",
"so",
"ckb",
"es",
"sw",
"sv",
"tg",
"ta",
"te",
"th",
"tr",
"uk",
"ur",
"uz",
"vi",
"cy",
"wo",
"zu"
],
"type": "string",
"x-ui": {
"order": 80,
"widget": "select",
"enum_labels": {
"af": "Afrikaans",
"am": "Amharic",
"ar": "Arabic",
"as": "Assamese",
"az": "Azerbaijani",
"be": "Belarusian",
"bg": "Bulgarian",
"bn": "Bengali",
"bs": "Bosnian",
"ca": "Catalan",
"cs": "Czech",
"cy": "Welsh",
"da": "Danish",
"de": "German",
"el": "Greek",
"en": "English",
"es": "Spanish",
"et": "Estonian",
"fa": "Persian",
"ff": "Fula (Pulaar)",
"fi": "Finnish",
"fr": "French",
"gl": "Galician",
"gu": "Gujarati",
"ha": "Hausa",
"he": "Hebrew",
"hi": "Hindi",
"hr": "Croatian",
"hu": "Hungarian",
"hy": "Armenian",
"id": "Indonesian",
"is": "Icelandic",
"it": "Italian",
"ja": "Japanese",
"jv": "Javanese",
"ka": "Georgian",
"kk": "Kazakh",
"kn": "Kannada",
"ko": "Korean",
"ky": "Kyrgyz",
"lb": "Luxembourgish",
"lg": "Luganda",
"ln": "Lingala",
"lo": "Lao",
"lt": "Lithuanian",
"lv": "Latvian",
"mi": "Māori",
"mk": "Macedonian",
"ml": "Malayalam",
"mn": "Mongolian",
"mr": "Marathi",
"ms": "Malay",
"mt": "Maltese",
"my": "Burmese",
"ne": "Nepali",
"nl": "Dutch",
"no": "Norwegian",
"oc": "Occitan",
"or": "Odia",
"pa": "Punjabi",
"pl": "Polish",
"ps": "Pashto",
"pt": "Portuguese",
"ro": "Romanian",
"ru": "Russian",
"sd": "Sindhi",
"sk": "Slovak",
"sl": "Slovenian",
"sn": "Shona",
"so": "Somali",
"sr": "Serbian",
"sv": "Swedish",
"sw": "Swahili",
"ta": "Tamil",
"te": "Telugu",
"tg": "Tajik",
"th": "Thai",
"tr": "Turkish",
"uk": "Ukrainian",
"ur": "Urdu",
"uz": "Uzbek",
"vi": "Vietnamese",
"wo": "Wolof",
"zh": "Mandarin Chinese",
"zu": "Zulu",
"ast": "Asturian",
"ceb": "Cebuano",
"ckb": "Sorani Kurdish",
"fil": "Filipino",
"kam": "Kamba",
"yue": "Cantonese",
"auto": "Auto-detect"
}
},
"default": "auto",
"description": "Language to enforce, as an ISO code, or auto to detect it from the text."
},
"voice_id": {
"enum": [
"Adam",
"Alice",
"Bella",
"Bill",
"Brian",
"Callum",
"Charlie",
"Chris",
"Daniel",
"Eric",
"George",
"Harry",
"Jessica",
"Laura",
"Liam",
"Lily",
"Matilda",
"River",
"Roger",
"Sarah",
"Will"
],
"type": "string",
"x-ui": {
"order": 90,
"widget": "select",
"enum_labels": {
"Adam": "Adam (male)",
"Bill": "Bill (male)",
"Eric": "Eric (male)",
"Liam": "Liam (male)",
"Lily": "Lily (female)",
"Will": "Will (male)",
"Alice": "Alice (female)",
"Bella": "Bella (female)",
"Brian": "Brian (male)",
"Chris": "Chris (male)",
"Harry": "Harry (male)",
"Laura": "Laura (female)",
"River": "River (female)",
"Roger": "Roger (male)",
"Sarah": "Sarah (female)",
"Callum": "Callum (male)",
"Daniel": "Daniel (male)",
"George": "George (male)",
"Charlie": "Charlie (male)",
"Jessica": "Jessica (female)",
"Matilda": "Matilda (female)"
}
},
"default": "Roger",
"description": "Preset voice."
},
"stability": {
"type": "number",
"x-ui": {
"step": 0.05,
"order": 70,
"widget": "slider"
},
"default": 0.5,
"maximum": 1,
"minimum": 0,
"description": "How steady the delivery is, 0 to 1. Lower is more expressive and more variable."
},
"output_format": {
"enum": [
"mp3_44100_128",
"mp3_44100_64",
"mp3_22050_32",
"opus_48000_128",
"pcm_24000",
"pcm_16000",
"wav_44100",
"ulaw_8000",
"alaw_8000"
],
"type": "string",
"x-ui": {
"order": 50,
"widget": "select",
"advanced": true,
"enum_labels": {
"alaw_8000": "A-law · 8 kHz",
"pcm_16000": "PCM (raw) · 16 kHz",
"pcm_24000": "PCM (raw) · 24 kHz",
"ulaw_8000": "μ-law · 8 kHz",
"wav_44100": "WAV · 44.1 kHz",
"mp3_22050_32": "MP3 · 22.05 kHz · 32 kbps",
"mp3_44100_64": "MP3 · 44.1 kHz · 64 kbps",
"mp3_44100_128": "MP3 · 44.1 kHz · 128 kbps",
"opus_48000_128": "Opus · 48 kHz · 128 kbps"
}
},
"default": "mp3_44100_128",
"description": "Audio container, sample rate and bitrate. pcm is raw audio without a file header."
},
"clone_strength": {
"type": "number",
"x-ui": {
"step": 0.05,
"order": 20,
"widget": "slider",
"advanced": true
},
"maximum": 1,
"minimum": 0,
"description": "Strength of a professional voice clone, 0 to 1. Has no effect on preset voices."
},
"similarity_boost": {
"type": "number",
"x-ui": {
"step": 0.05,
"order": 65,
"widget": "slider"
},
"default": 0.75,
"maximum": 1,
"minimum": 0,
"description": "How closely the speech follows the selected voice, 0 to 1."
},
"text_normalization_mode": {
"enum": [
"auto",
"on",
"off"
],
"type": "string",
"x-ui": {
"order": 30,
"widget": "select",
"advanced": true,
"enum_labels": {
"on": "Always",
"off": "Off",
"auto": "Auto"
}
},
"default": "auto",
"description": "Whether numbers, dates and abbreviations are spelled out before reading."
}
},
"additionalProperties": false
}HTTP 202 означает принятие задачи, а не завершение генерации. Сохраните полученный taskId и проверяйте эту задачу. Не создавайте новую, пока ждёте результат.
HTTP/1.1 202 Accepted
Location: /api/v1/jobs/recordInfo?taskId=job_01k3m8x9q2z4v7n5p6r8s0t1w3
{
"code": 200,
"msg": "success",
"request_id": "req_example_create",
"data": {
"taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
"state": "queued",
"estimatedCost": "0.750000"
}
}В ответе о приёме есть оценка стоимости — приложение сможет показать ту же сумму в истории задач и в расчётах.
curl --get "https://api.spicyapi.ai/api/v1/jobs/recordInfo" \
--data-urlencode "taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"Начните с интервала около 2 секунд и постепенно увеличивайте его. Прекратите опрос при конечном состоянии. После сбоя соединения используйте исходный taskId. Повторно создавать задачу можно только с исходным ключом идемпотентности и исходным телом запроса.
import { verifyWebhook } from "@spicyapi/sdk";
// express.raw keeps the bytes we signed; express.json never matches.
app.post("/hooks/spicy", express.raw({ type: "application/json" }), (req, res) => {
const { payload } = verifyWebhook({
rawBody: req.body,
timestamp: req.header("X-Webhook-Timestamp"),
signature: req.header("X-Webhook-Signature"),
payloadVersion: Number(req.header("X-Webhook-Payload-Version")),
secret: process.env.SPICY_WEBHOOK_SECRET,
});
res.status(200).end();
void handleFinishedTask(payload);
});Передайте callBackUrl при создании задачи — готовая запись придёт к вам POST-запросом, и никакого опроса не понадобится. В каждой доставке есть X-Webhook-Timestamp, X-Webhook-Signature и X-Webhook-Payload-Version. Подпись — это HMAC-SHA256 в base64 от taskId.timestamp.sha256(body), поэтому проверять её нужно по исходным байтам: если разобрать JSON и сериализовать заново, байты изменятся и проверка не пройдёт. Неудачные доставки повторяются, так что один и тот же taskId может прийти дважды — сделайте обработчик идемпотентным. Сначала ответьте 2xx, работу выполняйте после: медленный обработчик считается неудачной доставкой.
Обрабатывайте output только при state, равном succeeded. При ошибке проверьте errorCode, errorMessage и request_id. Стоимость и состояния в примерах не являются фактическим счётом.
{
"code": 200,
"msg": "success",
"request_id": "req_example_record",
"data": {
"taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
"model": "elevenlabs/v4-turbo/text-to-speech",
"state": "succeeded",
"output": {
"assets": [
{
"key": "tasks/2026/08/28/job_01k3m8x9q2z4v7n5p6r8s0t1w3/3f7a1c9e5b2d48f0a6c1e3d5b7f9a1c3.mp3",
"mime": "audio/mpeg",
"url": "https://example.r2.cloudflarestorage.com/results/job_01k3m8x9q2z4v7n5p6r8s0t1w3/result.mp3?X-Amz-Signature=SIGNATURE_FROM_RESPONSE",
"expiresAt": "2026-08-28T12:20:08.000Z"
}
]
},
"cost": "0.750000",
"settled": true,
"createdAt": "2026-08-28T12:00:00Z",
"completedAt": "2026-08-28T12:00:30Z"
}
}Доступные файлы можно открыть или скачать по assets[].url без заголовка API Authorization. Подписанная ссылка действует до expiresAt. Чтобы обновить её, повторно запросите задачу в течение срока хранения файла. У ожидающих или недоступных файлов URL отсутствует. Не передавайте подписанные ссылки посторонним.
Используйте SpicyAPI в приложении, терминале, ИИ-ассистенте или визуальном процессе. Выберите руководство по настройке.
Писать код выше вовсе не обязательно. Подключите сервер MCP один раз — и любой агент, который говорит на MCP (Claude Code, Codex, Cursor, Windsurf, VS Code, Gemini CLI, Cline, LibreChat), вызовет эту модель по имени. Либо запустите её из терминала одной командой.
Возьми elevenlabs/v4-turbo/text-to-speech и сгенерируй портрет танцовщицы в неоновом свете, сохрани в ./out/.
Агент найдёт модель в каталоге, сам загрузит локальный файл, покажет точную смету и предельную сумму списания — и дождётся вашего согласия. До этого ничего не списывается.
claude mcp add spicyapi -e SPICY_API_KEY=$SPICY_API_KEY \
-- npx --yes --package=@spicyapi/mcp spicyapi-mcp
npx skills add spicyapi-ai/spicy-skillПервая строка даёт агенту инструменты, вторая — Skill, то есть правила обращения с ними: сначала смета, потом списание; локальные файлы загружать, а не вставлять байтами; URL готового результата читать, а не угадывать. Остальные клиенты подключают тот же сервер через собственный файл настроек — см. раздел для разработчиков.
npx @spicyapi/cli tasks create --model elevenlabs/v4-turbo/text-to-speech \
--input-json '{"text":"Welcome back. Your files finished rendering a minute ago and are ready to download.","language":"auto","voice_id":"Roger","output_format":"mp3_44100_128","text_normalization_mode":"auto"}' \
--waitВходные данные взяты из схемы этого эндпоинта — той же, что и в примерах выше. --wait дождётся завершения задачи и выведет её, а --yes пропустит подтверждение в CI. Сначала задайте SPICY_API_KEY: один ключ работает и для API, и для CLI, и для сервера MCP.
npx @spicyapi/cli tasks create --model elevenlabs/v4-turbo/text-to-speech \
--input-json '{…}' --retention 1h --wait
npx @spicyapi/cli tasks get $TASK_ID # read back the retention that appliedКлюч --retention только сокращает срок — 30m, 1h, 7d или 0, чтобы удалить сразу после перехода задачи в конечное состояние. Реально действует наименьшее из трёх: ваш запрос, настройки аккаунта и предел платформы, — поэтому считайте его из записи задачи, а не исходите из того, что запрошенное число применилось. Запросить срок больше разрешённого аккаунтом нельзя: это ничего не изменит.
Установите узлы SpicyAPI через ComfyUI Manager или командой ниже и найдите на холсте ElevenLabs v4 Turbo · Text to Speech. У узла те же параметры, что и на этой странице, а цена показывается до запуска.
cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapiВстроенная панель читает ту же схему, что и эта страница, поэтому не может разойтись с API. Если содержимое должно индексироваться поиском по документации, возьмите JSON из /api/embed/models/ и отрисуйте его самостоятельно.
<iframe src="https://spicyapi.ai/embed/ru/models/elevenlabs-v4-turbo/api?model=elevenlabs%2Fv4-turbo%2Ftext-to-speech" width="100%" height="560" loading="lazy" title="Пример запроса" style="border:1px solid rgba(0,0,0,.12)"></iframe>