Публічний API Speechdash вже доступний

API Speechdash public тепер доступний за адресою api.speechdash.com/v1. Якщо ви розробляєте продукти, де людям потрібно прослуховувати текст, ви можете створювати документи та генерувати мовлення без відкриття веб-інтерфейсу.

У цьому пості розповідається, що було випущено, як працює оплата, та як здійснити свій перший запит за кілька хвилин.

Що робить API сьогодні

REST API повторює відомий вам стек прослуховування з додатку:

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

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

Синтез мовлення використовує ті самі хмарні голоси, що й відтворення в додатку. Використання списується з гаманця кредитів облікового запису за тими самими правилами, що й хмарне прослуховування у продукті.

Для кого це призначено

Команди звертаються до 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
• Хмарне відтворення
• Формати імпорту
• Що використовує кредити