API для бизнеса

Этот адрес для компаний, которые встраивают распознавание речи Speech2Words в свой продукт. Один токен открывает все сервисы: живая речь, файл, ссылка на видео, чат по расшифровке, история и оплата.

Как обращаться

В каждый запрос добавьте заголовок Authorization: Bearer и токен. Сервисы лежат по адресу /api/v1. Токен привязан к вашему входу: минуты, подписка и рубли списываются с этого счёта. Чужим токеном выпустить новый нельзя — только после входа на этой странице.

curl https://speech2words.ru/api/v1/account \
  -H "Authorization: Bearer iil_..."

Сервисы

• GET /api/v1/account — вход, баланс и подписка.
• GET /api/v1/languages и GET /api/v1/tariff — языки распознавания и цены.
• Живой микрофон: WebSocket wss://speech2words.ru/ws/listen?access_token=ТОКЕН&lang=ru. Шлите бинарные кадры PCM 16 бит, моно, 24000 Гц. Текст {type:stop} завершает фразу. В ответ приходят delta, completed, balance и halt.
• POST /api/v1/transcribe — файл. Поля: file, language, duration_seconds, diarize (1 делит по спикерам), source (upload или dictate).
• POST /api/v1/transcribe/url — JSON: url ролика YouTube, Rutube, VK или Дзен и language. В тексте будут метки времени.
• POST /api/v1/chat — JSON: transcript и messages (role и content). Ответ помощника по этой расшифровке.
• GET /api/v1/transcripts — список. POST /api/v1/transcripts — сохранить текст. GET /api/v1/transcripts/{id} — полный текст.
• POST /api/v1/clip-limit — сколько секунд ещё можно записать с учётом бесплатных минут, подписки и баланса.
• POST /api/v1/pay — пополнение, в теле minutes. POST /api/v1/pay/subscription — подписка, plan full или tg и period month или year. POST /api/v1/pay/subscription/cancel — остановить автопродление. POST /api/v1/pay/sync — подтянуть оплаченное.

Звук для /ws/listen может быть любым: микрофон, вкладка, запись разговора. Сервис только расшифровывает присланный PCM и не подключается к встречам Zoom, Google Meet или Контур.Толк. Звук встречи вы получаете сами: на нашем сайте это делает браузер Chrome, в своём клиенте можно использовать любой другой способ захвата.

Вы отвечаете за то, чтобы участники встречи или разговора согласились на запись и расшифровку. Нарушение правил площадки или закона остаётся на вызывающей стороне.

Бесплатные минуты дня, подписка и баланс работают так же, как на сайте. Запрос к /api/v1 без входа отвечает 401. Неверный токен тоже отвечает 401 и не тратит гостевые минуты.

Страница оплаты Схема всех запросов и ответов открывается в Swagger.