Публичный API Speechdash запущен

Публичный API Speechdash теперь доступен по адресу api.speechdash.com/v1. Если вы разрабатываете продукты, где пользователям нужно прослушивать текст, вы можете создавать документы и синтезировать речь без открытия браузерного интерфейса.

В этой статье мы расскажем, что уже реализовано, как работает биллинг и как сделать первый запрос за несколько минут.

Что доступно в API на данный момент

REST API повторяет знакомый вам стек прослушивания из приложения:

• Создание и управление документами в библиотеке Speechdash пользователя (импорт текста с указанием названия и языка)
• Синтез речи с предустановками голосов Narrator, Questioner и Expert на многих языках
• Просмотр, чтение, обновление и удаление документов через предсказуемые JSON-эндпоинты

Документы, созданные через API, отображаются в библиотеке на сайте speechdash.com. Ваши пользователи могут продолжать прослушивание в приложении, редактировать текст, экспортировать аудио или продолжать работу с другого устройства.

Синтез речи использует те же облачные голоса, что и встроенное воспроизведение. Использование списывается с кошелька кредитов аккаунта по тем же правилам, что и облачное прослушивание в продукте.

Для кого предназначен API

Команды обращаются к API, когда прослушивание должно быть встроено в другой продукт:

• LMS и образовательные платформы, которым нужно озвучивание заданий или статей
• Слои доступности внутри SaaS-инструментов
• Внутренние инструменты, которые пакетно импортируют контент для прослушивания
• Прототипы, которым нужна устная демонстрация до выпуска полноценного интерфейса

Если у ваших пользователей уже есть аккаунты Speechdash, у них остаётся один кошелёк и одна библиотека документов. API - это дополнительный вход, а не отдельный продукт.

Аутентификация и документация

Каждый аккаунт создаёт API-ключи в разделе Настройки → API в приложении. Ключи отображаются один раз; на сервере хранится только их префикс.

Отправляйте Authorization: Bearer sh_live_… в каждом запросе. Недействительные или отозванные ключи возвращают ответ 401.

Документация для разработчиков доступна в Центре справки:

• Обзор API (аутентификация, лимиты, биллинг, идемпотентность)
• Живой OpenAPI-контракт по адресу api.speechdash.com/v1/openapi.json

Маркетинговая страница Публичный API кратко рассказывает историю для нетехнических членов вашей команды.

Биллинг вкратце

Запросы на синтез резервируют расчётную стоимость, а затем списсываются по фактической длительности. Повторные попытки можно отправлять с заголовком Idempotency-Key при создании документа и синтезе речи, чтобы сетевой сбой не привёл к двойному списанию.

Ограничения по количеству запросов действуют на аккаунт (не на ключ). В ответах содержатся стандартные заголовки ограничений и Retry-After, если нужно сделать паузу.

Первый запрос за пять минут

1. Войдите на speechdash.com и откройте Настройки → API
2. Создайте ключ и сразу же скопируйте его
3. Ознакомьтесь с обзором API
4. Отправьте POST-запрос с коротким текстом на /v1/documents или вызовите /v1/audio/speech с предустановкой голоса и языком

Начните с двух предложений, прежде чем стримить целый раздел. В обзорной документации перечислены точные поля и примеры ответов.

Что будет дальше

Мы будем расширять API по мере роста потребностей продукта. Если вы интегрируетесь уже сейчас, присоединяйтесь в Discord для обратной связи или открывайте Центр справки, если что-то в контракте непонятно.

Спасибо, что разрабатываете с Speechdash. Мы рады услышать, что у вас получилось.

Похожие гайды

• Страница функции Публичный API
• Начало работы с Speechdash
• Облачное воспроизведение
• Форматы импорта
• Что использует кредиты