Download the PHP package tigusigalpa/yandex-speechkit-php without Composer
On this page you can find all versions of the php package tigusigalpa/yandex-speechkit-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download tigusigalpa/yandex-speechkit-php
More information about tigusigalpa/yandex-speechkit-php
Files in tigusigalpa/yandex-speechkit-php
Package yandex-speechkit-php
Short Description PHP SDK for Yandex SpeechKit API with Laravel support. Async speech recognition, speaker labeling, speech analysis.
License MIT
Homepage https://github.com/tigusigalpa/yandex-speechkit-php
Informations about the package yandex-speechkit-php
Yandex SpeechKit PHP SDK
PHP SDK для работы с Yandex SpeechKit API. Работает как самостоятельная библиотека или как Laravel-пакет. Если вам нужно транскрибировать аудио, определять спикеров или анализировать речь из PHP — вы по адресу.
Язык: Русский | English
Что умеет
- Асинхронное распознавание длинного аудио (до 4 часов / 1 ГБ)
- Форматы WAV, OGG_OPUS, MP3 и raw PCM
- Разделение по спикерам (диаризация) — кто что сказал
- Нормализация текста и фильтрация мата из коробки
- Мультиязычное распознавание
- Встраивается в Laravel через Facade и Service Provider
- Покрыт тестами
Экосистема
Пакет входит в небольшое семейство PHP-библиотек для Yandex Cloud:
- tigusigalpa/yandex-cloud-client-php — аутентификация: OAuth-токены, генерация и автообновление IAM-токенов
- tigusigalpa/yandexgpt-php — интеграция с YandexGPT
Об авторизации можно не думать — yandex-cloud-client-php сам разберётся с IAM-токенами.
Требования
- PHP ^8.0
- Laravel ^8.0|^9.0|^10.0|^11.0|^12.0 (опционально, для интеграции с Laravel)
- tigusigalpa/yandex-cloud-client-php ^1.0
Установка
Настройка Laravel
1. Опубликуйте конфиг
Создаст файл config/yandex-speechkit.php.
2. Пропишите .env
Минимум нужен folder ID и один из способов авторизации:
3. Service Provider
Регистрируется автоматически через package discovery Laravel — ничего делать не нужно.
Использование
Чистый PHP (без Laravel)
С Laravel
Полный пример со всеми настройками
Передача аудио в base64
Нет удалённого URL? Можно передать содержимое файла напрямую:
Работа с raw PCM
Отмена операции
Передумали? Не проблема:
Справочник API
Методы клиента
| Метод | Что делает | Возвращает |
|---|---|---|
recognizeFileAsync($request) |
Запускает асинхронное распознавание | Operation |
getRecognition($operationId) |
Забирает результат распознавания | RecognitionResult |
deleteRecognition($operationId) |
Удаляет сохранённые результаты | bool |
getOperation($operationId) |
Проверяет статус операции | Operation |
cancelOperation($operationId) |
Отменяет операцию | Operation |
recognizeAndWait($request, $poll = 10, $maxWait = 14400) |
Всё в одном: отправить, дождаться, вернуть результат | RecognitionResult |
getCloudClient() |
Возвращает базовый cloud-клиент | YandexCloudClient |
Поддерживаемые форматы
| Формат | Тип | Как использовать |
|---|---|---|
| WAV | Контейнер | AudioFormat::container('WAV') |
| OGG_OPUS | Контейнер | AudioFormat::container('OGG_OPUS') |
| MP3 | Контейнер | AudioFormat::container('MP3') |
| LINEAR16_PCM | Raw | AudioFormat::raw('LINEAR16_PCM', 16000, 1) |
Модели распознавания
general— основная, подходит для большинства задачgeneral:rc— release candidate, новее, но менее обкатанаgeneral:deprecated— старая версия, пока доступнаdeferred-general— то же качество, но обрабатывается в очереди (дешевле)deferred-general:rc— отложенная RCdeferred-general:deprecated— отложенная, старая версия
Обработка ошибок
Три типа исключений, чтобы можно было реагировать по ситуации:
Тесты
Ссылки
- Документация SpeechKit
- Справочник API
- Этот репозиторий на GitHub
- yandex-cloud-client-php — слой авторизации
- yandexgpt-php — интеграция с YandexGPT
Лицензия
MIT. См. LICENSE.
Автор
Игорь Сазонов — GitHub · [email protected]
Участие в разработке
PR и issues приветствуются. См. CONTRIBUTING.md.
All versions of yandex-speechkit-php with dependencies
guzzlehttp/guzzle Version ^7.0
illuminate/support Version ^8.0|^9.0|^10.0|^11.0|^12.0
tigusigalpa/yandex-cloud-client-php Version ^1.0