API

Озвучка из ваших программ. Ключ создаётся в кабинете, доступен на тарифах «Про» и «Студия». Символы списываются с того же баланса, что и в студии.

Озвучить текст

POST /api/v1/tts — в ответ сразу приходит аудиофайл. До 5000 символов за запрос, до 60 запросов в минуту.

curl -X POST https://tellfair.com/api/v1/tts \
  -H "Authorization: Bearer tf_live_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{"text": "Привет! Это проверка.", "presetId": "news-anchor", "format": "mp3"}' \
  --output hello.mp3

Поле	Что это
`text`	Текст, обязательно. Для пресетов с пометкой «теги» работают `[laugh]`, `[chuckle]`, `[sigh]`.
`presetId`	id пресета из `/api/v1/presets`. Задаёт голос и параметры.
`voiceId`	Другой встроенный голос поверх пресета.
`customVoiceId`	Ваш клонированный голос (id есть в кабинете).
`params`	Ручная настройка: `exaggeration` 0.25–2, `cfg_weight` 0–1, `temperature` 0.05–1.5, `speed_factor` 0.5–2.
`format`	`mp3` (по умолчанию), `wav` или `opus`.
`seed`	Число. С одинаковым seed повтор звучит одинаково.

В заголовке ответа X-Chars-Charged — сколько символов списали.

Список пресетов и голосов

GET /api/v1/presets — ключ не нужен.

curl https://tellfair.com/api/v1/presets

Ошибки

Ответ с ошибкой — JSON { "error": "текст", "code": "код" }.

`401`	Нет ключа или он отозван.
`402`	Кончились символы (`no_chars`) или на тарифе нет API (`plan_upgrade`).
`429`	Больше 60 запросов в минуту.
`5xx`	Сбой на нашей стороне. Символы за такой запрос возвращаются.