tts-1
TTS-1 превращает подготовленный текст в речевое аудио с выбором голосов, скорости воспроизведения и форматов. OpenAI оптимизирует эту версию для меньшей задержки; она подходит для оперативного озвучивания, короткого повествования и потоковой выдачи готового сценария.
О модели
Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.
TTS-1 — модель синтеза речи OpenAI, оптимизированная для скорости. Она получает произносимые слова и создаёт аудио, а не расшифровку или письменный ответ. Примеры производителя включают озвучивание статей, речь на нескольких языках и воспроизведение по мере поступления аудио. TTS-1 даёт меньшую задержку по сравнению с TTS-1 HD, ориентированной на качество. Поэтому полезный выбор — что важнее задаче: быстрое воспроизведение или более качественное повествование.
Сценарий генерации строится вокруг модели, входного текста и выбранного голоса. Справочник OpenAI ограничивает текст 4096 символами: это символьный лимит, а не токеновое окно контекста. Подготовьте сценарий до синтеза: нужные слушателю предложения, раскрытые сокращения, чтение имён, количеств и заголовков. Для длинной статьи организуйте разделы в самостоятельно понятные отрывки, не рассматривая весь документ как один речевой запрос.
Текущий список голосов именно TTS-1: alloy, ash, coral, echo, fable, onyx, nova, sage и shimmer. Это готовые голоса, а не полный набор каждой новой речевой модели. Они оптимизированы для английского; многоязычная речь поддерживается передачей входа на нужном языке. Выбирайте голос по типичному отрывку со словарём и темпом итогового сценария. Сохраняйте выбор между связанными клипами, когда важна непрерывность.
Аудио может поступать фрагментами, чтобы воспроизведение началось до завершения генерации всего файла. Это поток речи из текста, а не двусторонний разговор. Документированные форматы — MP3, Opus, AAC, FLAC, WAV и PCM; по умолчанию MP3. MP3 и AAC сжимают аудио; Opus подходит для потоков и связи; FLAC не имеет потерь. WAV не требует декодирования сжатого аудио, raw PCM содержит знаковые 16-битные отсчёты little-endian с частотой 24 кГц без заголовка файла. При приоритете времени ответа OpenAI рекомендует WAV или PCM.
Справочник речи предоставляет скорость от 0.25 до 4.0, по умолчанию 1.0. Дополнительное поле инструкций естественным языком с TTS-1 не работает, вывод событий SSE не поддерживается. Документированные настройки — сценарий, голос, скорость и формат; настройки акцента, эмоции или шёпота новых моделей не следует приписывать этой версии. Выберите понятную скорость, затем проверьте озвученные слова и паузы, не предполагая, что число символов задаёт точную длительность.
Руководство языков включает английский, русский, украинский, французский, немецкий, испанский, португальский, итальянский, арабский, китайский, японский, корейский, хинди, казахский и многие другие. Речь следует языку переданного текста. Поэтому многоязычное задание начинается с переведённого сценария и целевой аудитории: TTS — этап озвучивания, а не инструкция перевести или переписать. Для объявления подготовьте точное сообщение и имена. В учебном повествовании ясно обозначьте словами границы разделов и определения.
Готовый материал может быть короткой инструкцией, озвученным отрывком или сегментом большого монтажа. Проверяйте произношение, полноту, темп и формат по фактическому выходу. Храните сценарий с аудио, чтобы локализовать последующие исправления. Руководство OpenAI требует ясно сообщать слушателям, что голос создан ИИ. Это раскрытие относится к прослушиванию; оно не превращает TTS-1 в запись человеческого голоса и не добавляет клонирование.
Ailoot Ultra · Озвучка POST /v1/audio/speech openai/tts-1
openai/tts-1Начало
TTS-1 превращает подготовленный текст в речевое аудио с выбором голосов, скорости воспроизведения и форматов. OpenAI оптимизирует эту версию для меньшей задержки; она подходит для оперативного озвучивания, короткого повествования и потоковой выдачи готового сценария.
- Допустимые входные данные
- Текст
- Результаты
- Аудио
Доступно в Ailoot · входные данные и методы
Ailoot Ultra · Озвучка POST /v1/audio/speech
- Входные данные
text- Результат
audio- Выходной формат
- mp3
| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Полеmodel | Типstring | ТребованиеОбязательно | Значения и ограничения openai/tts-1 | По умолчанию— |
Поле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.03 за 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", "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
Псевдонимы путей метода
Используйте пути методов, указанные выше.
Связанные ID для вызова
FAQ · tts-1
- Какие входные данные и результаты доступны?
POST /v1/audio/speech·openai/tts-1:text→audio- Какие поля использует запрос?
POST /v1/audio/speech·openai/tts-1:model,input,voice- Какие ограничения действуют?
POST /v1/audio/speech·openai/tts-1:input.maximum_length:4096