Skip to content

Latest commit

 

History

History
84 lines (59 loc) · 1.97 KB

README.md

File metadata and controls

84 lines (59 loc) · 1.97 KB
Raw

Speech-to-Text API

This project provides a FastAPI-based web service to convert audio files to text using the SpeechRecognition library.

Features

  • Convert various audio formats (MP3, WAV, etc.) to text.
  • Support for multiple languages (currently set to Thai).
  • Update speech recognition engine and language dynamically via API.
  • Support for both file upload and base64 encoded audio input.

Requirements

  • Python 3.9+
  • FastAPI
  • SpeechRecognition
  • PyDub
  • MoviePy

Installation

  1. Clone the repository:

    git clone https://github.com/PongpreechaSuea/Speech2Text.git
cd Speech2Text

  2. Create a virtual environment and activate it:

    python -m venv venv
source venv/bin/activate  # On Windows use venv\Scripts\activate

  3. Install the required packages:

    pip install -r requirements.txt

Configuration

Update the config.py file with your desired settings:

  • Speech recognition engine
  • Default language
  • File paths for temporary storage
  • Server host and port

Usage

  1. Start the server: python app.py Copy

  2. The API will be available at http://localhost:3000 (or the port you configured)

  3. Use the following endpoints:

  • GET /: Get API information
  • PUT /v1/api/using/engine: Update speech-to-text engine
  • PUT /v1/api/using/language: Update speech-to-text language
  • POST /v1/api/using/speech2text: Convert speech to text (file upload)
  • POST /v1/api/using_base64/speech2text_base64: Convert speech to text (base64 encoded audio)

API Documentation

Once the server is running, you can access the API documentation at http://localhost:3000/docs

Examples

Convert audio file to text

import requests

url = "http://localhost:3000/v1/api/using/speech2text"
files = {"file": open("audio.mp3", "rb")}
response = requests.post(url, files=files)
print(response.json())

Speech-to-Text API Overview