Перейти к основному контенту

Seed Speech 2.0 API

Без цензуры — Модель заявляет об отсутствии контент-фильтра. SpicyAPI передаёт запрос без проверки контента платформой; ответственность за законность и за согласие участников остаётся на клиенте.Посмотреть все модели с этим уровнем фильтрации
bytedance/seed-speech-2.0/text-to-speech

Seed Speech 2.0 от ByteDance text-to-speech превращает сценарий в моно MP3 24 кГц на одном из 41 готовых голосов. Скорость, высота и громкость настраиваются, подсказки простым языком задают интонацию, контент-фильтр не применяется.

От $0.072/1 000 символов
Запустить модель

Рабочая область

Отправить запрос

Быстрый старт

Примеры используют публичные параметры выбранного эндпоинта. Замените API-ключ и примеры медиафайлов, затем отправьте запрос со своего сервера.

SDK и интеграции
POSThttps://api.spicyapi.ai/api/v1/jobs/createTask

Аутентификация API

Храните 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": "bytedance/seed-speech-2.0/text-to-speech",
  "input": {
    "text": "Welcome back. Your files finished rendering a minute ago and are ready to download.",
    "voice_id": "stokie_en",
    "output_format": "mp3"
  }
}'

# 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Обязательно

Слова, которые нужно произнести, в точности как написано. Тарификация за каждую 1000 символов, включая пробелы и знаки препинания. До 5000 символов.

По умолчанию
Не задано
Ограничения
minLength:1
maxLength:5000
sample_rateintegerНеобязательно

Частота дискретизации звука в Гц: 8000, 16000, 22050, 24000, 32000, 44100, 48000. По умолчанию: 24000. Цену не меняет.

По умолчанию
Не задано
Допустимые значения
8000160002205024000320004410048000
output_formatstringНеобязательно

Формат файла: mp3 (по умолчанию) или opus, то есть файл Ogg Opus, меньший по размеру при том же качестве. Цену не меняет.

По умолчанию
"mp3"
Допустимые значения
"mp3""opus"
languagestringНеобязательно

Принудительно задаёт язык чтения. Оставьте пустым, чтобы он определялся по сценарию.

По умолчанию
Не задано
Допустимые значения
"zh""en""ja""es-mx""id""pt-br""ko""it""de""fr"
volumenumberНеобязательно

Множитель громкости от 0,5 до 2; 1 — обычный уровень. Цену не меняет.

По умолчанию
1
Ограничения
minimum:0.5
maximum:2
pitchintegerНеобязательно

Сдвиг высоты тона в полутонах, от -12 до 12; 0 сохраняет собственную высоту голоса. Цену не меняет.

По умолчанию
0
Ограничения
minimum:-12
maximum:12
speednumberНеобязательно

Скорость речи от 0,5 (медленнее) до 2 (быстрее); 1 — обычный темп голоса. Цену не меняет.

По умолчанию
1
Ограничения
minimum:0.5
maximum:2
instructionsstringНеобязательно

Указание на простом языке о тоне, эмоции, темпе или громкости. Формирует подачу и не произносится. До 1000 символов; не тарифицируется.

По умолчанию
Не задано
Ограничения
maxLength:1000
voice_idstringНеобязательно

Один из 41 готовых голосов. Суффикс показывает, на какие языки рассчитан голос. По умолчанию — stokie_en.

По умолчанию
"stokie_en"
Допустимые значения
"vivi_mixed_en_zh_ja_es_id""mindy_en_es_id_pt_zh""stokie_en""dacey_en""tim_en""kian_en_zh""cedric_en_zh""sophie_en_zh""jean_en_zh""magnus_en_zh""mabel_en_zh""nadia_en_zh""opal_en_zh""pearl_en_zh""quentin_en_zh""vienna_mixed_en_zh""alina_mixed_en_zh""corinne_mixed_en_zh""esther_mixed_en_zh""freya_mixed_en_zh""gigi_mixed_en_zh""holly_mixed_en_zh""lyla_mixed_en_zh""daisy_mixed_en_zh""tracy_es_zh""jess_ja_es_id_pt_en_zh""pinky_es_ko_mixed_en_zh""sweety_ja_es""sandy_es_mixed_en_zh""sven_de""minimi_ja""usseau_fr""felipe_es""han_id""martins_pt""enzo_it""shane_ko""bonnie_zh""felix_zh""celeste_zh""monkey_king_zh"

Отследить задачу

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": "bytedance/seed-speech-2.0/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 отсутствует. Не передавайте подписанные ссылки посторонним.

SDK и интеграции

Используйте SpicyAPI в приложении, терминале, ИИ-ассистенте или визуальном процессе. Выберите руководство по настройке.

SDKs
TypeScript · Python · Go · PHP · Java
CLI
Команды терминала и скрипты автоматизации.
MCP
Claude Code · Cursor · Codex
Agent Skill
Многоразовые инструкции для ИИ-ассистента.
n8n
Узлы сообщества для самостоятельного хостинга и импортируемые шаблоны HTTP Request для n8n Cloud.
ComfyUI
Процессы работы с изображениями, видео и аудио на узловом холсте.

Другие интеграции

SillyTavernTelegram / DiscordApp proxyOpenAI SDKLangChainVercel AI SDK
Посмотреть готовые рабочие процессы

Использование в ComfyUI

Установите узлы SpicyAPI через ComfyUI Manager или командой ниже и найдите на холсте Seed Speech 2.0 · Text to Speech. У узла те же параметры, что и на этой странице, а цена показывается до запуска.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi
Готовые воркфлоуРуководство по установкеИсходный код на GitHub