tts-1-hd
TTS-1 HD преобразует письменный текст в более качественное речевое аудио с выбором готовых голосов, скорости и шести форматов. OpenAI ориентирует HD на качество повествования в отличие от малой задержки TTS-1; модель подходит для готового озвучивания, учебного материала и смонтированных аудиоотрывков.
О модели
Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.
TTS-1 HD — модель синтеза речи OpenAI, оптимизированная для качества аудио. На входе — подготовленный сценарий, на выходе — речь. HD отличается от ориентированного на скорость профиля TTS-1: OpenAI описывает TTS-1 как вариант с меньшей задержкой, но более низким качеством. Поэтому HD полезна для повествования, когда качество готовой дорожки важнее максимально быстрого начала воспроизведения. Письменная статья, часть урока или отточенное объяснение могут стать аудиоматериалом.
Основные входы — выбранная модель, точный текст и голос. Справочник речи производителя ограничивает сценарий 4096 символами на запрос. Это длина письменного входа, а не гарантия длительности аудио. Готовьте понятный на слух текст: раскрывайте неоднозначные сокращения, решайте, как произносить количества, и сохраняйте связность отрывка. Длинный урок или статью делите по смысловым границам, сохраняя порядок использования полученных частей.
Текущее руководство OpenAI перечисляет девять встроенных голосов TTS-1 HD: alloy, ash, coral, echo, fable, onyx, nova, sage и shimmer. Голоса оптимизированы для английского, но руководство TTS поддерживает несколько языков при передаче текста на нужном языке. Голоса полезнее сравнивать на одном типичном сценарии с именами и специальной лексикой будущего материала. Сохраняйте голос и скорость, если несколько клипов образуют единое повествование.
Формат по умолчанию — MP3. Opus и AAC дают альтернативное сжатое аудио; FLAC — сжатие без потерь; WAV — несжатое аудио. PCM содержит сырые знаковые 16-битные отсчёты little-endian с частотой 24 кГц без заголовка файла. Варианты служат разным целям: компактный файл для распространения, потоковый материал или аудио для монтажа. OpenAI рекомендует WAV или PCM для быстрого ответа, когда важны затраты на декодирование. Формат не меняет сценарий и не добавляет отдельную модель управления голосом.
Речь может выдаваться фрагментами, позволяя начать воспроизведение до готовности всего файла. Это поток текст–аудио, а не двунаправленный голосовой разговор. Справочник поддерживает скорость от 0.25 до 4.0, по умолчанию 1.0. Отдельное поле инструкций естественным языком с TTS-1 HD не работает; вывод событий SSE для модели не поддерживается. Документированные настройки — сценарий, готовый голос, скорость и формат, а не интерфейс акцента или эмоциональных указаний новых речевых моделей.
Руководство языков включает русский, украинский, английский, французский, немецкий, испанский, португальский, итальянский, китайский, японский, корейский, арабский, хинди и казахский среди поддерживаемых. Подготовьте сценарий на целевом языке: синтез озвучивает, а не переводит текст. В учебном контенте ясно формулируйте определения и переходы. Для объясняющего аудио подготовьте точное сообщение и все важные имена. Англоязычная оптимизация голоса остаётся значимой при оценке конкретного языка и словаря.
Практический сценарий HD создаёт аудиоотрывок для прослушивания, проверки и включения в готовый материал. Проверьте озвучивание каждого предложения, допустимость произношения имён и количеств и понятность выбранного темпа. Храните письменный сценарий рядом с аудио для привязки исправления к отрывку. OpenAI требует ясно раскрывать искусственное происхождение голоса. HD обозначает семейство TTS с приоритетом качества; само по себе это не обещает точный тайминг, индивидуальный голос диктора или выразительные настройки другой модели.
Ailoot Ultra · Озвучка POST /v1/audio/speech openai/tts-1-hd
openai/tts-1-hdНачало
TTS-1 HD преобразует письменный текст в более качественное речевое аудио с выбором готовых голосов, скорости и шести форматов. OpenAI ориентирует HD на качество повествования в отличие от малой задержки TTS-1; модель подходит для готового озвучивания, учебного материала и смонтированных аудиоотрывков.
- Допустимые входные данные
- Текст
- Результаты
- Аудио
Доступно в Ailoot · входные данные и методы
Ailoot Ultra · Озвучка POST /v1/audio/speech
- Входные данные
text- Результат
audio- Выходной формат
- mp3
| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Полеmodel | Типstring | ТребованиеОбязательно | Значения и ограничения openai/tts-1-hd | По умолчанию— |
Полеinput | Типstring | ТребованиеОбязательно | Значения и ограничения Минимальная длина: 1 Максимальная длина: 4 096 Единица: символы Unicode | По умолчанию— |
Полеvoice | Типstring | ТребованиеОбязательно | Значения и ограничения alloy | По умолчанию— |
Сочетания входных материалов
text_to_speech · Обязательно: input
Параметры и жизненный цикл метода
| Параметр | Контракт |
|---|---|
Параметрcontent_type | Контрактapplication/json |
Параметрrequired | Контрактmodel, input, voice |
Параметрvoice_ids | Контрактalloy |
Параметрmax_input_characters | Контракт4096 |
Параметрother_options | Контрактfalse |
Параметрinput | Контрактточный текст UTF-8; количество символов Unicode без нормализации |
Параметрmaterial_types | Контрактtext |
Жизненный цикл: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Фактически возвращённый task_id или запись в медиатеке
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Выберите точный голос из профиля этой модели.
Входные символы и секунды аудио — разные единицы учёта.
Тарифы
Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.
- Быстрый режим
- Не указано При выборе быстрого режима
- Режим flex
- Не указано При выборе режима flex
- Максимальная интенсивность рассуждений
- Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)
Ставки Ailoot
Цены по конфигурациям
Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.
| Конфигурация | Шкала ставок | Оплачиваемое количество | Расчётное количество | Расчётная единица | Плата |
|---|---|---|---|---|---|
| КонфигурацияБазовые тарифы на токены | Шкала ставокБазовая ставка | Оплачиваемое количество— | Расчётное количество— | Расчётная единица— | Плата Вход · Входные токены — / 1K токенов Выход · Выходные токены — / 1K токенов Вход · Чтение кэша — / 1K токенов Вход · Запись в кэш — / 1K токенов Вход · Запись в кэш, 1 час — / 1K токенов |
| КонфигурацияUltra | Шкала ставок— | Оплачиваемое количествоКаждая кодовая точка Unicode считается одним символом, включая символы Han. | Расчётное количество— | Расчётная единицаза 1K входных символов | Плата Вход · входной символ $0.06 за 1K входных символов |
| КонфигурацияЗа запрос | Шкала ставок— | Оплачиваемое количество— | Расчётное количествоОдин запрос | Расчётная единица— | Плата Вход $0 за запрос |
Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →
Примеры запросов
Ailoot Ultra · Озвучка
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "openai/tts-1-hd", "input": "Good afternoon! This is a short voice take.", "voice": "alloy"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/audio/speech \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o speech.mp3
Получить и сохранить результаты
Ailoot Ultra · Озвучка
mp3
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Чтение другого содержимого
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o media-assets.json
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_MEDIA_TASK_ID:?Set the actual ID returned by the response or media-library metadata}"
export AILOOT_MEDIA_TASK_ID
resource_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_MEDIA_TASK_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/media/tasks/$resource_id" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o media-task.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path("media-task.json").read_text())))
PY_RESULT
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_ASSET_ID:?Set the actual ID returned by the response or media-library metadata}"
export AILOOT_ASSET_ID
resource_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_ASSET_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/media/assets/$resource_id" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o media-asset.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path("media-asset.json").read_text())))
PY_RESULT
Сохраняйте все готовые результаты
Сохраняйте каждый полностью полученный ответ, файл и элемент содержимого.
Сохраняйте полный бинарный результат и заголовки. Если возвращаются JSON или несколько результатов, сохраняйте каждый элемент данных и загружайте ресурс по каждому фактически возвращённому подписанному URL.
Если нужно проверить исходный ответ
Сохраняйте исходный operation_id/X-Client-Request-ID для сверки без повторной отправки; отдельного маршрута опроса аудио нет.
Поля ответа
| Поле | Тип |
|---|---|
Полеbinary audio | Типbytes |
Полеresponse headers | Типheaders |
Ошибки и дальнейшие шаги
| Ответ | Условие | Следующий шаг |
|---|---|---|
Ответ400 · invalid_request_error | УсловиеНеверные обязательные поля, представление материалов или значение параметра | Следующий шагИсправьте указанные поля перед новым запросом на создание. |
Ответserver_error | УсловиеВозвращённый ответ указывает, что операция или результат требуют проверки | Следующий шагСохраните исходный возвращённый ID операции или задачи, заголовки запроса и ответ; продолжайте поддерживаемые операции чтения исходной операции. Не отправляйте запрос создания повторно. |
Псевдонимы
Псевдонимы моделей
Ailoot Ultra openai/tts-1-hd
Псевдонимы путей метода
Используйте пути методов, указанные выше.
Связанные ID для вызова
FAQ · tts-1-hd
- Какие входные данные и результаты доступны?
POST /v1/audio/speech·openai/tts-1-hd:text→audio- Какие поля использует запрос?
POST /v1/audio/speech·openai/tts-1-hd:model,input,voice- Какие ограничения действуют?
POST /v1/audio/speech·openai/tts-1-hd:input.maximum_length:4096