228f67d07f
- Добавил предзагрузку модели по-умолчанию - Убрал метрики - Добавил скрипты для старта - Для отчаянных Dockerfile для сборки контейнера на 70ГБ
87 lines
2.0 KiB
Markdown
87 lines
2.0 KiB
Markdown
# Simple ASR Server
|
||
|
||
Простой сервер для автоматического распознавания речи (ASR) на базе OpenAI Whisper.
|
||
|
||
## Особенности
|
||
|
||
- Поддержка различных моделей Whisper (tiny, base, small, medium, large, turbo)
|
||
- Три формата вывода: plaintext, simple JSON, полный JSON
|
||
- Параметр speedup для ускорения аудио перед распознаванием
|
||
- Автоматическая конвертация аудио в поддерживаемый формат
|
||
- API ключи для безопасности
|
||
- Docker поддержка
|
||
|
||
## Быстрый старт
|
||
|
||
### Локальная установка
|
||
|
||
1. Установите зависимости:
|
||
```bash
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
2. Скопируйте и настройте переменные окружения:
|
||
```bash
|
||
cp .env.example .env
|
||
```
|
||
|
||
3. Запустите сервер:
|
||
```bash
|
||
python app.py
|
||
```
|
||
|
||
### Docker
|
||
|
||
1. Постройте и запустите контейнер:
|
||
```bash
|
||
docker-compose up --build
|
||
```
|
||
|
||
## API
|
||
|
||
### POST /transcribe
|
||
|
||
Распознавание речи из аудиофайла.
|
||
|
||
**Параметры:**
|
||
- `file` (файл) - Аудиофайл для распознавания
|
||
- `model_name` (опционально) - Модель Whisper для использования
|
||
- `output_format` - Формат вывода: `plaintext`, `simple`, или `json`
|
||
- `speedup` - Коэффициент ускорения аудио (0.25-4.0)
|
||
|
||
**Заголовки:**
|
||
- `x-api-key` - API ключ
|
||
|
||
**Примеры:**
|
||
|
||
```bash
|
||
# Простой текстовый вывод
|
||
curl -X POST "http://localhost:9854/transcribe?output_format=plaintext&speedup=1.5" \
|
||
-H "x-api-key: YOUR_API_KEY" \
|
||
-F "file=@audio.wav"
|
||
|
||
# JSON с только текстом
|
||
curl -X POST "http://localhost:9854/transcribe?output_format=simple" \
|
||
-H "x-api-key: YOUR_API_KEY" \
|
||
-F "file=@audio.wav"
|
||
|
||
# Полный JSON ответ с использованием другой модели
|
||
curl -X POST "http://localhost:9854/transcribe?output_format=json&model_name=base" \
|
||
-H "x-api-key: YOUR_API_KEY" \
|
||
-F "file=@audio.wav"
|
||
```
|
||
|
||
### GET /health
|
||
|
||
Проверка состояния сервера.
|
||
|
||
## Переменные окружения
|
||
|
||
См. `.env.example` для полного списка доступных переменных:
|
||
|
||
- `HOST` - Хост сервера (по умолчанию: 0.0.0.0)
|
||
- `PORT` - Порт сервера (по умолчанию: 9854)
|
||
- `DEFAULT_MODEL` - Модель по умолчанию (по умолчанию: turbo)
|
||
- `MODEL_DOWNLOAD_ROOT` - Папка для загрузки моделей
|
||
- `KEYS_FILE` - Файл с API ключами
|