Введение
TTS-1 превращает написанное сообщение в звуковой файл. Эта модель Speech рассчитана на быструю подготовку коротких реплик: уведомления о завершении задачи или инструкции в приложении. Она не слушает собеседника и не сочиняет ответ. OpenAI объявила об отключении 6 января 2027 года.
Ключевые возможности и особенности
Для TTS-1 доступны alloy, ash, coral, echo, fable, onyx, nova, sage и shimmer. Голоса оптимизированы для английского; тексты на других языках и важные имена следует проверить на слух. Один голос помогает сохранить единство связанных уведомлений.
TTS-1 выдаёт MP3, Opus, AAC, FLAC, WAV или исходный PCM. Сжатый файл удобен для мобильного уведомления, несжатые данные — для собственного проигрывателя. Темп задаётся от 0,25 до 4, при этом число оплачиваемых символов не меняется.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
text | Да | Передайте TTS-1 точный текст сообщения, до 4096 символов с пробелами и пунктуацией. Не менее 1 символов · Не более 4096 символов |
voice_id | Нет | Выберите один из девяти голосов TTS-1; по умолчанию используется alloy. |
speed | Нет | Темп TTS-1 настраивается от 0,25 до 4; обычной скорости соответствует 1. |
output_format | Нет | Укажите формат TTS-1. PCM — это 24 кГц, 16 бит little-endian без заголовка WAV. |
Стоимость
$0.003 / 1 000 символов
Сценарии использования
Панель задач может через TTS-1 сообщить об уже установленном результате. Приложение заранее определяет состояние операции и точный текст, чтобы озвучка не придумала её исход.
При настройке устройства отдельный клип TTS-1 для каждого шага позволяет воспроизводить нужную инструкцию. Изменённую фразу можно заменить без повторной генерации всей последовательности.
Руководство по промптам и практические советы
Пишите для TTS-1 именно слова, которые должен услышать человек. Раскрывайте неоднозначные сокращения, проверяйте даты, коды и десятичные числа в предложении. Указание «говори спокойно» станет произносимым текстом: свободные инструкции о подаче не управляют этой старой моделью.
В одном запросе TTS-1 допускается до 4096 символов, размер готового файла ограничен 32 MiB. Делите длинный текст, особенно при медленном WAV или PCM. Прослушайте запись до включения в интерфейс и обозначьте синтетическую природу голоса. Сохраните исходный текст и параметры воспроизведения для перехода до отключения.
Быстрый старт API
# 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": "openai/tts-1/text-to-speech",
"input": {
"text": "Welcome back. Your files finished rendering a minute ago and are ready to download.",
"voice_id": "alloy",
"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.

