tts-1-1106
TTS-1-1106 преобразует переданный текст в речь через Ailoot. Отправьте текст и поддерживаемое значение voice, затем сохраните полный бинарный аудиоответ.
О модели
Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.
TTS-1-1106 использует /v1/audio/speech с точным ID модели tts-1-1106. Запрос требует model, input и voice. Поместите текст озвучки, устную инструкцию или диалог приложения в input и используйте выбранное для задачи значение voice. Сохраняйте орфографию, пунктуацию и нужные формулировки в тексте для озвучивания.
Подготовьте текст как законченный фрагмент. Записывайте имена и сокращения в форме, подходящей для нужного произношения, и храните текст вместе с полученным файлом, чтобы при следующей правке можно было изменить конкретную строку. Для последовательности клипов сохраняйте стабильный идентификатор текста и выбранный voice рядом с каждым результатом.
Метод возвращает бинарное аудио и заголовки ответа. Сохраните полные байты с фактически полученным типом содержимого. Если ответ или ваша медиатека предоставляет task_id, сохраните этот идентификатор для /v1/media/tasks/{task_id}; он отличается от operation_id. Прослушайте весь файл и сравните произнесённый текст с отправленным.
Ailoot Ultra · Speech POST /v1/audio/speech tts-1-1106
tts-1-1106Начало
TTS-1-1106 преобразует переданный текст в речь через Ailoot. Отправьте текст и поддерживаемое значение voice, затем сохраните полный бинарный аудиоответ.
- Допустимые входные данные
- Текст
- Результаты
- Аудио
Доступно в Ailoot · входные данные и методы
Ailoot Ultra · Speech POST /v1/audio/speech
- Входные данные
text- Результат
audio
| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Полеmodel | Типstring | ТребованиеОбязательно | Значения и ограничения tts-1-1106 Условия: Используйте этот селектор маршрутизации Ailoot в точности. | По умолчанию— |
Полеinput | Типstring | ТребованиеОбязательно | Значения и ограничения Условия: | По умолчанию— |
Полеvoice | Типstring | ТребованиеОбязательно | Значения и ограничения Условия: | По умолчанию— |
Параметры и жизненный цикл метода
| Параметр | Контракт |
|---|---|
Параметрcontent_type | Контрактapplication/json |
Параметрrequired | Контрактmodel, input, voice |
Параметрoptional | Контракт |
Параметрmaterial_types | Контрактtext |
Параметрconditions | КонтрактИспользуйте этот селектор маршрутизации Ailoot в точности. |
Жизненный цикл: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Фактически возвращённый task_id или выбранная запись библиотеки; operation_id — отдельный идентификатор
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Тарифы
Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.
- Быстрый режим
- Не указано При выборе быстрого режима
- Режим flex
- Не указано При выборе режима flex
- Максимальная интенсивность рассуждений
- Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)
Ставки Ailoot
Цены по конфигурациям
Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.
| Конфигурация | Шкала ставок | Расчётная единица | Плата |
|---|---|---|---|
| КонфигурацияБазовые тарифы на токены | Шкала ставокБазовая ставка | Расчётная единица— | Плата Вход · Входные токены — / 1K токенов Выход · Выходные токены — / 1K токенов Вход · Чтение кэша — / 1K токенов Вход · Запись в кэш — / 1K токенов Вход · Запись в кэш, 1 час — / 1K токенов |
| Конфигурациявходной символ | Шкала ставок— | Расчётная единицаза входной символ | Плата Вход · входной символ $0.00003 за входной символ |
Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →
Примеры запросов
Ailoot Ultra · Speech
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
: "${AILOOT_VOICE:?Set an actual customer material or documented value}"
export AILOOT_VOICE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "tts-1-1106", "input": "Good afternoon! This is a short voice take.", "voice": "YOUR_DOCUMENTED_VOICE"}')
p['voice']=os.environ['AILOOT_VOICE']
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.bin
# Submit once. Retain the complete result, original identifiers and every response header.
Получить и сохранить результаты
Ailoot Ultra · Speech
GET /v1/media/tasks/{task_id}GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Сохраняйте все готовые результаты
Сохраняйте каждый полностью полученный ответ, файл и элемент содержимого.
Сохраните полный ответ и заголовки, исходные идентификаторы, каждый фактический результат и все поля использования и учёта. Сохраните каждый уникальный ресурс, принадлежащий Ailoot, и каждую роль, которая на него ссылается.
Если нужно проверить исходный ответ
Сохраните исходный X-Client-Request-ID, ответ и заголовки. Неизвестный результат или result_pending_check не разрешает повторное создание.
Поля ответа
| Поле | Тип |
|---|---|
Полеbinary audio | Типbytes |
Полеresponse headers | Типheaders |
Ошибки и дальнейшие шаги
| Ответ | Условие | Следующий шаг |
|---|---|---|
Ответ400 · invalid_request_error | УсловиеОбязательное поле, селектор модели, тип или представление входных данных недопустимы. | Следующий шагИзучите возвращённые сведения о проверке данных перед подготовкой отдельного запроса. |
Ответ | УсловиеИсходный запрос или результат неизвестен либо требует проверки. | Следующий шагСохраните исходные идентификаторы и заголовки; читайте только поддерживаемые записи статуса или библиотеки. Не отправляйте запрос на создание повторно. |
Псевдонимы
Псевдонимы моделей
Ailoot Ultra tts-1-1106
Псевдонимы путей метода
Используйте пути методов, указанные выше.
Связанные ID для вызова
FAQ · tts-1-1106
- Какие входные данные и результаты доступны?
POST /v1/audio/speech·tts-1-1106:text→audio- Какие поля использует запрос?
POST /v1/audio/speech·tts-1-1106:model,input,voice