Configuration Globale (config.yaml)

OneASR se configure via un fichier central unique config.yaml situé à la racine du projet.

---

Configuration Complète de Référence

# Configuration Unifiée de OneASR

# Clé API principale pour l'authentification des requêtes
api_key: sk-oneasr-v1-p_L3kXm9QZ8sT2vA4wE7rY1u

# Boîte à outils ASR globale & Prétraitement audio
ASR-Toolkit:
  vad:
    model: "silero_vad"          # Moteur VAD : silero_vad
    threshold: 0.5               # Seuil de probabilité (0.0 - 1.0)
    min_speech_duration_ms: 250  # Durée minimale de parole
    min_silence_duration_ms: 300 # Durée de silence déclenchant la découpe
    padding_ms: 100              # Marge de sécurité audio

  chunking:
    target_chunk_duration: 6.0   # Longueur idéale du segment (secondes)
    max_chunk_duration: 8.0      # Limite maximale pour division des longs audios
    min_pause_duration: 0.4      # Seuil de pause naturelle
    min_sentence_duration: 2.0   # Durée sémantique minimale

  post_process:
    remove_repeats: true         # Nettoyage des répétitions hallucinées
    normalize_text: true         # Formatage de la ponctuation et des espaces

# Fournisseurs ASR & Chargement des Moteurs
ASR-Providers:

  # 1. Moteur de Streaming Temps Réel (Sherpa-ONNX Zipformer)
  xasr:
    enable: true
    engine: xasr
    load:
      model_name: xasr-zh-en
      tokens_path: models/chunk-160ms-model/tokens.txt
      encoder_path: models/chunk-160ms-model/encoder-160ms.onnx
      decoder_path: models/chunk-160ms-model/decoder-160ms.onnx
      joiner_path: models/chunk-160ms-model/joiner-160ms.onnx
      provider: cpu
      sample_rate: 16000
      decoding_method: greedy_search
    properties:
      categories:
        - RealtimeASR
      languages: zh, en

  # 2. Transcription de Fichiers Faster-Whisper
  faster-whisper:
    enable: true
    engine: faster-whisper
    load:
      model_name: medium
      model_path: models/faster-whisper-medium
      device: cuda # ou cpu
      compute_type: float16 # ou int8
    properties:
      categories:
        - FileASR
      languages: zh, en, ja, ko, fr, de, es, it, ru, pt

---

Remplacement par Variables d’Environnement

Toutes les clés de configuration peuvent être redéfinies par des variables d’environnement au démarrage du conteneur :

• ONEASR_API_KEY : Remplace api_key
• ONEASR_PORT : Port d’écoute du serveur (par défaut : 8000)
• ONEASR_WORKERS : Nombre de processus de travail Uvicorn (par défaut : 1)