Для разработчиков

API расшифровки и распознавания

Загружайте аудио, видео и документы на обработку из своих скриптов и сервисов. Оплата — кредитами аккаунта: 1 кредит = минута аудио или страница документа.

Как начать

Зарегистрируйтесь и пополните баланс или возьмите пакет — тарифы.
Откройте кабинет → API и создайте ключ (Bearer-токен).
Отправляйте запросы на https://2text.ru/wp-json/slovomol/v1.

Аутентификация

curl -H "Authorization: Bearer ВАШ_КЛЮЧ" \
  https://2text.ru/wp-json/slovomol/v1/account

Эндпоинты

Метод	Путь	Назначение
GET	`/account`	Баланс, кредиты пакета, остаток бесплатных минут
POST	`/jobs`	Создать задачу: multipart-загрузка файла (аудио/видео/фото/PDF, до 80 МБ)
GET	`/jobs/<id>`	Статус и результат задачи (текст, спикеры, таймкоды)
POST	`/streams`	Открыть потоковую сессию (микрофон чанками)
POST	`/streams/<id>/audio`	Отправить аудиофрагмент сессии
GET	`/streams/<id>/partial`	Промежуточный текст
POST	`/streams/<id>/stop`	Завершить сессию, финальный текст и списание

Тарификация и лимиты

Списание идёт по той же кредитной модели, что в кабинете: сначала бесплатные минуты, затем кредиты пакета, затем оплата с баланса.
При ошибке обработки средства и кредиты возвращаются автоматически.
На каждый ключ действуют rate-limit и ограничение по concurrent-задачам; превышение — HTTP 429 с подсказкой Retry-After.

Формат ответа

{
  "id": 1234,
  "status": "ready",
  "text": "…расшифровка…",
  "segments": [
    { "start": 0.0, "end": 4.2, "speaker": "Спикер 1", "text": "…" }
  ],
  "duration_seconds": 3600,
  "download": { "txt": "…", "srt": "…", "docx": "…" }
}

Ключ даётся одному аккаунту; не передавайте его третьим лицам — оплата списывается с вашего баланса. Вопросы по API — напишите нам.