Configuración Global (config.yaml)

OneASR se configura a través de un único archivo central config.yaml ubicado en la raíz del directorio del proyecto.

---

Configuración Completa de Referencia

# Configuración Unificada de OneASR

# Clave API maestra para autenticación de endpoints
api_key: sk-oneasr-v1-p_L3kXm9QZ8sT2vA4wE7rY1u

# Kit de herramientas ASR global y preprocesamiento de audio
ASR-Toolkit:
  vad:
    model: "silero_vad"          # Motor VAD: silero_vad
    threshold: 0.5               # Umbral de probabilidad (0.0 - 1.0)
    min_speech_duration_ms: 250  # Duración mínima de voz
    min_silence_duration_ms: 300 # Duración de silencio para dividir
    padding_ms: 100              # Relleno del búfer de audio

  chunking:
    target_chunk_duration: 6.0   # Longitud ideal del fragmento (segundos)
    max_chunk_duration: 8.0      # Límite máximo para división de audio largo
    min_pause_duration: 0.4      # Umbral de pausa natural
    min_sentence_duration: 2.0   # Duración semántica mínima

  post_process:
    remove_repeats: true         # Eliminar repeticiones alucinadas
    normalize_text: true         # Formatear puntuación y espacios

# Proveedores ASR y Carga de Motores
ASR-Providers:

  # 1. Motor de Streaming en Tiempo Real (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. Transcripción de Archivos Faster-Whisper
  faster-whisper:
    enable: true
    engine: faster-whisper
    load:
      model_name: medium
      model_path: models/faster-whisper-medium
      device: cuda # o cpu
      compute_type: float16 # o int8
    properties:
      categories:
        - FileASR
      languages: zh, en, ja, ko, fr, de, es, it, ru, pt

---

Sobrescritura mediante Variables de Entorno

Cualquier clave de configuración puede sobrescribirse con variables de entorno durante el inicio del contenedor:

• ONEASR_API_KEY: Sobrescribe api_key
• ONEASR_PORT: Puerto de escucha del servidor (por defecto: 8000)
• ONEASR_WORKERS: Número de procesos de trabajo de Uvicorn (por defecto: 1)