1043 lines
45 KiB
Python
1043 lines
45 KiB
Python
#!/usr/bin/env python3
|
|
# -*- encoding: utf-8 -*-
|
|
# Copyright FunASR (https://github.com/alibaba-damo-academy/FunASR). All Rights Reserved.
|
|
# MIT License (https://opensource.org/licenses/MIT)
|
|
|
|
import json
|
|
import time
|
|
import copy
|
|
import torch
|
|
import random
|
|
import string
|
|
import logging
|
|
import os.path
|
|
import numpy as np
|
|
from tqdm import tqdm
|
|
|
|
from omegaconf import DictConfig, ListConfig
|
|
from funasr.utils.misc import deep_update
|
|
from funasr.register import tables
|
|
from funasr.utils.load_utils import load_bytes
|
|
from funasr.download.file import download_from_url
|
|
from funasr.utils.timestamp_tools import timestamp_sentence
|
|
from funasr.utils.timestamp_tools import timestamp_sentence_en
|
|
from funasr.download.download_model_from_hub import download_model
|
|
from funasr.utils.vad_utils import slice_padding_audio_samples
|
|
from funasr.utils.vad_utils import merge_vad
|
|
from funasr.utils.load_utils import load_audio_text_image_video
|
|
from funasr.train_utils.set_all_random_seed import set_all_random_seed
|
|
from funasr.train_utils.load_pretrained_model import load_pretrained_model
|
|
from funasr.utils import export_utils
|
|
from funasr.utils.postprocess_hotwords import apply_postprocess_hotwords_to_results
|
|
from funasr.utils import misc
|
|
|
|
|
|
def is_npu_available():
|
|
"""检查NPU是否可用。"""
|
|
try:
|
|
import torch_npu
|
|
|
|
return torch_npu.npu.is_available()
|
|
except ImportError:
|
|
return False
|
|
|
|
|
|
def _resolve_ncpu(config, fallback=4):
|
|
"""Return a positive integer representing CPU threads from config."""
|
|
value = config.get("ncpu", fallback)
|
|
try:
|
|
value = int(value)
|
|
except (TypeError, ValueError):
|
|
value = fallback
|
|
return max(value, 1)
|
|
|
|
|
|
def _get_import_errors():
|
|
"""Internal: get import errors."""
|
|
try:
|
|
import funasr
|
|
except Exception:
|
|
return {}
|
|
get_import_errors = getattr(funasr, "get_import_errors", None)
|
|
if get_import_errors is not None:
|
|
return get_import_errors()
|
|
return dict(getattr(funasr, "_IMPORT_ERRORS", {}))
|
|
|
|
|
|
def _format_unregistered_component_error(component_type, component_name, registry):
|
|
"""Internal: format unregistered component error.
|
|
|
|
Args:
|
|
component_type: TODO.
|
|
component_name: TODO.
|
|
registry: TODO.
|
|
"""
|
|
registered = sorted(registry.keys())
|
|
preview = ", ".join(registered[:80])
|
|
if len(registered) > 80:
|
|
preview += f", ... ({len(registered)} total)"
|
|
if not preview:
|
|
preview = "(none)"
|
|
|
|
import_errors = _get_import_errors()
|
|
if import_errors:
|
|
lines = [
|
|
f" - {name}: {error}"
|
|
for name, error in sorted(import_errors.items())[:50]
|
|
]
|
|
remaining = len(import_errors) - len(lines)
|
|
if remaining > 0:
|
|
lines.append(f" ... {remaining} more import failures hidden")
|
|
import_error_text = "\n".join(lines)
|
|
else:
|
|
import_error_text = " (none recorded)"
|
|
|
|
return (
|
|
f"{component_type} '{component_name}' is not registered.\n"
|
|
f"Registered {component_type} keys ({len(registered)}): {preview}\n"
|
|
"Some modules may have failed to import during auto-registration. "
|
|
"Set FUNASR_IMPORT_DEBUG=1 to print failures during import, or "
|
|
"FUNASR_STRICT_IMPORT=1 to fail fast.\n"
|
|
f"Recorded import failures:\n{import_error_text}"
|
|
)
|
|
|
|
|
|
try:
|
|
from funasr.models.campplus.utils import sv_chunk, postprocess, distribute_spk
|
|
from funasr.models.campplus.cluster_backend import ClusterBackend
|
|
except:
|
|
pass
|
|
|
|
|
|
def prepare_data_iterator(data_in, input_len=None, data_type=None, key=None):
|
|
""" """
|
|
data_list = []
|
|
key_list = []
|
|
filelist = [".scp", ".txt", ".json", ".jsonl", ".text"]
|
|
|
|
chars = string.ascii_letters + string.digits
|
|
if isinstance(data_in, str):
|
|
if data_in.startswith("http://") or data_in.startswith("https://"): # url
|
|
data_in = download_from_url(data_in)
|
|
|
|
if isinstance(data_in, str) and os.path.exists(
|
|
data_in
|
|
): # wav_path; filelist: wav.scp, file.jsonl;text.txt;
|
|
_, file_extension = os.path.splitext(data_in)
|
|
file_extension = file_extension.lower()
|
|
if file_extension in filelist: # filelist: wav.scp, file.jsonl;text.txt;
|
|
with open(data_in, encoding="utf-8") as fin:
|
|
for line in fin:
|
|
key = "rand_key_" + "".join(random.choice(chars) for _ in range(13))
|
|
if data_in.endswith(".jsonl"): # file.jsonl: json.dumps({"source": data})
|
|
lines = json.loads(line.strip())
|
|
data = lines["source"]
|
|
key = lines.get("key", key)
|
|
else: # filelist, wav.scp, text.txt: id \t data or data
|
|
lines = line.strip().split(maxsplit=1)
|
|
data = lines[1] if len(lines) > 1 else lines[0]
|
|
key = lines[0] if len(lines) > 1 else key
|
|
|
|
data_list.append(data)
|
|
key_list.append(key)
|
|
else:
|
|
if key is None:
|
|
# key = "rand_key_" + "".join(random.choice(chars) for _ in range(13))
|
|
key = misc.extract_filename_without_extension(data_in)
|
|
data_list = [data_in]
|
|
key_list = [key]
|
|
elif isinstance(data_in, (list, tuple)):
|
|
if data_type is not None and isinstance(data_type, (list, tuple)): # mutiple inputs
|
|
data_list_tmp = []
|
|
for data_in_i, data_type_i in zip(data_in, data_type):
|
|
key_list, data_list_i = prepare_data_iterator(
|
|
data_in=data_in_i, data_type=data_type_i
|
|
)
|
|
data_list_tmp.append(data_list_i)
|
|
data_list = []
|
|
for item in zip(*data_list_tmp):
|
|
data_list.append(item)
|
|
else:
|
|
# [audio sample point, fbank, text]
|
|
data_list = data_in
|
|
key_list = []
|
|
for data_i in data_in:
|
|
if isinstance(data_i, str) and os.path.exists(data_i):
|
|
key = misc.extract_filename_without_extension(data_i)
|
|
else:
|
|
if key is None:
|
|
key = "rand_key_" + "".join(random.choice(chars) for _ in range(13))
|
|
key_list.append(key)
|
|
|
|
else: # raw text; audio sample point, fbank; bytes
|
|
if isinstance(data_in, bytes): # audio bytes
|
|
data_in = load_bytes(data_in)
|
|
if key is None:
|
|
key = "rand_key_" + "".join(random.choice(chars) for _ in range(13))
|
|
data_list = [data_in]
|
|
key_list = [key]
|
|
|
|
return key_list, data_list
|
|
|
|
|
|
class AutoModel:
|
|
|
|
def __init__(self, **kwargs):
|
|
"""Initialize AutoModel with ASR model and optional sub-models.
|
|
|
|
Args:
|
|
model (str): Model name (hub alias or full ID) or local path.
|
|
device (str): Device for inference. "cuda:0", "cpu", "mps", "npu:0".
|
|
Falls back to CPU if specified device is unavailable.
|
|
vad_model (str, optional): VAD model for long audio segmentation.
|
|
Enables processing of any-length audio.
|
|
vad_kwargs (dict, optional): VAD config, e.g. {"max_single_segment_time": 60000}.
|
|
punc_model (str, optional): Punctuation restoration model.
|
|
Not needed for Fun-ASR-Nano/SenseVoice/Qwen3-ASR (they output punctuation natively).
|
|
spk_model (str, optional): Speaker model for diarization ("cam++" or full model ID).
|
|
Requires vad_model. For Qwen3-ASR, also requires forced_aligner.
|
|
spk_mode (str, optional): Speaker diarization mode. "punc_segment" (default) or "vad_segment".
|
|
hub (str): Model hub. "ms" (ModelScope, default) or "hf" (HuggingFace).
|
|
ncpu (int): CPU threads (default: 4).
|
|
disable_update (bool): Skip version check on startup.
|
|
disable_pbar (bool): Disable tqdm progress bars.
|
|
**kwargs: Additional model-specific parameters (passed to config.yaml overrides).
|
|
|
|
Examples:
|
|
>>> model = AutoModel(model="paraformer-zh", vad_model="fsmn-vad", punc_model="ct-punc")
|
|
>>> model = AutoModel(model="FunAudioLLM/Fun-ASR-Nano-2512", trust_remote_code=True,
|
|
... remote_code="./model.py", vad_model="fsmn-vad", spk_model="cam++", hub="hf")
|
|
"""
|
|
try:
|
|
from funasr.utils.version_checker import check_for_update
|
|
|
|
check_for_update(disable=kwargs.get("disable_update", False))
|
|
except:
|
|
pass
|
|
|
|
log_level = getattr(logging, kwargs.get("log_level", "INFO").upper())
|
|
logging.basicConfig(level=log_level)
|
|
|
|
model, kwargs = self.build_model(**kwargs)
|
|
|
|
# if vad_model is not None, build vad model else None
|
|
vad_model = kwargs.get("vad_model", None)
|
|
vad_kwargs = {} if kwargs.get("vad_kwargs", {}) is None else kwargs.get("vad_kwargs", {})
|
|
if vad_model is not None:
|
|
logging.info("Building VAD model.")
|
|
vad_kwargs["model"] = vad_model
|
|
vad_kwargs["model_revision"] = kwargs.get("vad_model_revision", "master")
|
|
vad_kwargs["device"] = kwargs["device"]
|
|
vad_kwargs.setdefault("ncpu", kwargs.get("ncpu", 4))
|
|
if "hub" in kwargs:
|
|
vad_kwargs.setdefault("hub", kwargs["hub"])
|
|
vad_model, vad_kwargs = self.build_model(**vad_kwargs)
|
|
|
|
# if punc_model is not None, build punc model else None
|
|
punc_model = kwargs.get("punc_model", None)
|
|
punc_kwargs = {} if kwargs.get("punc_kwargs", {}) is None else kwargs.get("punc_kwargs", {})
|
|
if punc_model is not None:
|
|
logging.info("Building punc model.")
|
|
punc_kwargs["model"] = punc_model
|
|
punc_kwargs["model_revision"] = kwargs.get("punc_model_revision", "master")
|
|
punc_kwargs["device"] = kwargs["device"]
|
|
punc_kwargs.setdefault("ncpu", kwargs.get("ncpu", 4))
|
|
if "hub" in kwargs:
|
|
punc_kwargs.setdefault("hub", kwargs["hub"])
|
|
punc_model, punc_kwargs = self.build_model(**punc_kwargs)
|
|
|
|
# if spk_model is not None, build spk model else None
|
|
spk_model = kwargs.get("spk_model", None)
|
|
spk_kwargs = {} if kwargs.get("spk_kwargs", {}) is None else kwargs.get("spk_kwargs", {})
|
|
cb_kwargs = (
|
|
{} if spk_kwargs.get("cb_kwargs", {}) is None else spk_kwargs.get("cb_kwargs", {})
|
|
)
|
|
if spk_model is not None:
|
|
logging.info("Building SPK model.")
|
|
spk_kwargs["model"] = spk_model
|
|
spk_kwargs["model_revision"] = kwargs.get("spk_model_revision", "master")
|
|
spk_kwargs["device"] = kwargs["device"]
|
|
spk_kwargs.setdefault("ncpu", kwargs.get("ncpu", 4))
|
|
if "hub" in kwargs:
|
|
spk_kwargs.setdefault("hub", kwargs["hub"])
|
|
spk_model, spk_kwargs = self.build_model(**spk_kwargs)
|
|
self.cb_model = ClusterBackend(**cb_kwargs).to(kwargs["device"])
|
|
spk_mode = kwargs.get("spk_mode", "punc_segment")
|
|
if spk_mode not in ["default", "vad_segment", "punc_segment"]:
|
|
logging.error("spk_mode should be one of default, vad_segment and punc_segment.")
|
|
self.spk_mode = spk_mode
|
|
|
|
self.kwargs = kwargs
|
|
self.model = model
|
|
self.vad_model = vad_model
|
|
self.vad_kwargs = vad_kwargs
|
|
self.punc_model = punc_model
|
|
self.punc_kwargs = punc_kwargs
|
|
self.spk_model = spk_model
|
|
self.spk_kwargs = spk_kwargs
|
|
self.model_path = kwargs.get("model_path")
|
|
self._store_base_configs()
|
|
|
|
@staticmethod
|
|
def build_model(**kwargs):
|
|
"""Download model from hub, build all components, and load pretrained weights.
|
|
|
|
This method handles the full model construction pipeline:
|
|
1. Download model files from ModelScope/HuggingFace (if not local)
|
|
2. Parse config.yaml to determine model class, tokenizer, frontend
|
|
3. Instantiate tokenizer, frontend, and model via the registry
|
|
4. Load pretrained weights from model.pt
|
|
|
|
Args:
|
|
**kwargs: Must include 'model' (str). All other config.yaml fields can be overridden.
|
|
|
|
Returns:
|
|
tuple: (model, kwargs) where model is the instantiated nn.Module and
|
|
kwargs contains the resolved configuration.
|
|
"""
|
|
assert "model" in kwargs
|
|
if "model_conf" not in kwargs:
|
|
logging.info("download models from model hub: {}".format(kwargs.get("hub", "ms")))
|
|
kwargs = download_model(**kwargs)
|
|
|
|
set_all_random_seed(kwargs.get("seed", 0))
|
|
|
|
device = kwargs.get("device", "cuda")
|
|
if (
|
|
(device.startswith("cuda") and not torch.cuda.is_available())
|
|
or (device.startswith("xpu") and not torch.xpu.is_available())
|
|
or (device.startswith("mps") and not torch.backends.mps.is_available())
|
|
or (device.startswith("npu") and not is_npu_available())
|
|
or kwargs.get("ngpu", 1) == 0
|
|
):
|
|
device = "cpu"
|
|
kwargs["batch_size"] = 1
|
|
kwargs["device"] = device
|
|
|
|
ncpu = _resolve_ncpu(kwargs, 4)
|
|
kwargs["ncpu"] = ncpu
|
|
if torch.get_num_threads() != ncpu:
|
|
torch.set_num_threads(ncpu)
|
|
|
|
# build tokenizer
|
|
tokenizer = kwargs.get("tokenizer", None)
|
|
kwargs["tokenizer"] = tokenizer
|
|
kwargs["vocab_size"] = -1
|
|
|
|
if tokenizer is not None:
|
|
tokenizers = (
|
|
tokenizer.split(",") if isinstance(tokenizer, str) else tokenizer
|
|
) # type of tokenizers is list!!!
|
|
tokenizers_conf = kwargs.get("tokenizer_conf", {})
|
|
tokenizers_build = []
|
|
vocab_sizes = []
|
|
token_lists = []
|
|
|
|
### === only for kws ===
|
|
token_list_files = kwargs.get("token_lists", [])
|
|
seg_dicts = kwargs.get("seg_dicts", [])
|
|
### === only for kws ===
|
|
|
|
if not isinstance(tokenizers_conf, (list, tuple, ListConfig)):
|
|
tokenizers_conf = [tokenizers_conf] * len(tokenizers)
|
|
|
|
for i, tokenizer in enumerate(tokenizers):
|
|
tokenizer_class = tables.tokenizer_classes.get(tokenizer)
|
|
tokenizer_conf = tokenizers_conf[i]
|
|
|
|
### === only for kws ===
|
|
if len(token_list_files) > 1:
|
|
tokenizer_conf["token_list"] = token_list_files[i]
|
|
if len(seg_dicts) > 1:
|
|
tokenizer_conf["seg_dict"] = seg_dicts[i]
|
|
### === only for kws ===
|
|
|
|
tokenizer = tokenizer_class(**tokenizer_conf)
|
|
tokenizers_build.append(tokenizer)
|
|
token_list = tokenizer.token_list if hasattr(tokenizer, "token_list") else None
|
|
token_list = (
|
|
tokenizer.get_vocab() if hasattr(tokenizer, "get_vocab") else token_list
|
|
)
|
|
vocab_size = -1
|
|
if token_list is not None:
|
|
vocab_size = len(token_list)
|
|
|
|
if vocab_size == -1 and hasattr(tokenizer, "get_vocab_size"):
|
|
vocab_size = tokenizer.get_vocab_size()
|
|
token_lists.append(token_list)
|
|
vocab_sizes.append(vocab_size)
|
|
|
|
if len(tokenizers_build) <= 1:
|
|
tokenizers_build = tokenizers_build[0]
|
|
token_lists = token_lists[0]
|
|
vocab_sizes = vocab_sizes[0]
|
|
|
|
kwargs["tokenizer"] = tokenizers_build
|
|
kwargs["vocab_size"] = vocab_sizes
|
|
kwargs["token_list"] = token_lists
|
|
|
|
# build frontend
|
|
frontend = kwargs.get("frontend", None)
|
|
kwargs["input_size"] = None
|
|
if frontend is not None:
|
|
frontend_class = tables.frontend_classes.get(frontend)
|
|
frontend = frontend_class(**kwargs.get("frontend_conf", {}))
|
|
kwargs["input_size"] = (
|
|
frontend.output_size() if hasattr(frontend, "output_size") else None
|
|
)
|
|
kwargs["frontend"] = frontend
|
|
# build model
|
|
model_class = tables.model_classes.get(kwargs["model"])
|
|
if model_class is None:
|
|
raise RuntimeError(
|
|
_format_unregistered_component_error(
|
|
"model", kwargs["model"], tables.model_classes
|
|
)
|
|
)
|
|
model_conf = {}
|
|
deep_update(model_conf, kwargs.get("model_conf", {}))
|
|
deep_update(model_conf, kwargs)
|
|
model = model_class(**model_conf)
|
|
|
|
# init_param
|
|
init_param = kwargs.get("init_param", None)
|
|
if init_param is not None:
|
|
if os.path.exists(init_param):
|
|
logging.info(f"Loading pretrained params from {init_param}")
|
|
load_pretrained_model(
|
|
model=model,
|
|
path=init_param,
|
|
ignore_init_mismatch=kwargs.get("ignore_init_mismatch", True),
|
|
oss_bucket=kwargs.get("oss_bucket", None),
|
|
scope_map=kwargs.get("scope_map", []),
|
|
excludes=kwargs.get("excludes", None),
|
|
)
|
|
else:
|
|
print(f"error, init_param does not exist!: {init_param}")
|
|
|
|
# fp16
|
|
if kwargs.get("fp16", False):
|
|
model.to(torch.float16)
|
|
elif kwargs.get("bf16", False):
|
|
model.to(torch.bfloat16)
|
|
model.to(device)
|
|
model.eval()
|
|
|
|
if not kwargs.get("disable_log", True):
|
|
tables.print()
|
|
|
|
return model, kwargs
|
|
|
|
def __call__(self, *args, **cfg):
|
|
"""Internal: call .
|
|
|
|
Args:
|
|
*args: Variable positional arguments.
|
|
**cfg: Configuration overrides.
|
|
"""
|
|
kwargs = self.kwargs
|
|
deep_update(kwargs, cfg)
|
|
res = self.model(*args, kwargs)
|
|
return res
|
|
|
|
def generate(self, input, input_len=None, progress_callback=None, **cfg):
|
|
"""Run speech recognition on input audio.
|
|
|
|
This is the primary user-facing method. It automatically routes to:
|
|
- inference() if no vad_model is configured (single utterance)
|
|
- inference_with_vad() if vad_model is configured (long audio with segmentation)
|
|
|
|
Args:
|
|
input: Audio input. Accepts:
|
|
- File path (str): "audio.wav", "audio.mp3"
|
|
- URL (str): "https://..."
|
|
- numpy array: raw audio samples (float32, 16kHz)
|
|
- list: batch of file paths or arrays
|
|
- bytes: raw audio bytes
|
|
input_len (tensor, optional): Length of each input sample.
|
|
progress_callback (callable, optional): fn(current, total) called during processing.
|
|
**cfg: Runtime parameters:
|
|
- cache (dict): State cache for streaming mode. Pass {} for first call.
|
|
- hotword (str/list): Keywords to boost recognition accuracy.
|
|
- postprocess_hotwords (str/list/dict): Text-level hotword correction after
|
|
decoding. Unlike model-level ``hotword``, this runs on the final text.
|
|
- postprocess_hotword_file (str): Hotword file path. Each line is a target
|
|
word or an explicit mapping like ``错误词=>目标词``.
|
|
- postprocess_hotword_threshold (float): Fuzzy match threshold in [0, 1].
|
|
- return_postprocess_hotword_matches (bool): Include replacement details.
|
|
- language (str): Language hint ("auto", "zh", "en", "Chinese", etc.)
|
|
- batch_size_s (int): Dynamic batch total duration in seconds.
|
|
- is_final (bool): Last chunk flag for streaming mode.
|
|
- return_spk_res (bool): Return speaker diarization results.
|
|
- sentence_timestamp (bool): Return sentence-level timestamps.
|
|
- use_itn (bool): Apply inverse text normalization (SenseVoice).
|
|
|
|
Returns:
|
|
list[dict]: Results for each input sample. Common fields:
|
|
- "key" (str): Sample identifier
|
|
- "text" (str): Recognized text
|
|
- "timestamp" (list): [[start_ms, end_ms], ...] per character/word
|
|
- "sentence_info" (list): [{text, start, end, spk, timestamp}, ...] when spk enabled
|
|
"""
|
|
self._reset_runtime_configs()
|
|
if self.vad_model is None:
|
|
results = self.inference(
|
|
input, input_len=input_len, progress_callback=progress_callback, **cfg
|
|
)
|
|
if self.punc_model is not None:
|
|
deep_update(self.punc_kwargs, cfg)
|
|
for result in results:
|
|
punc_res = self.inference(
|
|
result["text"], model=self.punc_model, kwargs=self.punc_kwargs, **cfg
|
|
)
|
|
if cfg.get("return_raw_text", self.kwargs.get("return_raw_text", False)):
|
|
result["raw_text"] = copy.copy(result["text"])
|
|
result["text"] = punc_res[0]["text"]
|
|
return apply_postprocess_hotwords_to_results(results, cfg)
|
|
|
|
else:
|
|
results = self.inference_with_vad(
|
|
input, input_len=input_len, progress_callback=progress_callback, **cfg
|
|
)
|
|
return apply_postprocess_hotwords_to_results(results, cfg)
|
|
|
|
def inference(
|
|
self,
|
|
input,
|
|
input_len=None,
|
|
model=None,
|
|
kwargs=None,
|
|
key=None,
|
|
progress_callback=None,
|
|
**cfg,
|
|
):
|
|
"""Run model inference on input data (internal method).
|
|
|
|
Handles batching, timing, and progress reporting. Called by generate()
|
|
and inference_with_vad(). Typically not called directly by users.
|
|
|
|
Args:
|
|
input: Audio data, file path, or text (for punc model).
|
|
input_len (tensor, optional): Input lengths for batch.
|
|
model (nn.Module, optional): Override model (used for VAD/PUNC/SPK sub-models).
|
|
kwargs (dict, optional): Override kwargs (used for sub-model configs).
|
|
key (list, optional): Sample identifiers.
|
|
progress_callback (callable, optional): Progress reporting function.
|
|
**cfg: Additional config merged into kwargs.
|
|
|
|
Returns:
|
|
list[dict]: Model inference results.
|
|
"""
|
|
if kwargs is None:
|
|
self._reset_runtime_configs()
|
|
kwargs = self.kwargs if kwargs is None else kwargs
|
|
if "cache" in kwargs:
|
|
kwargs.pop("cache")
|
|
deep_update(kwargs, cfg)
|
|
model = self.model if model is None else model
|
|
|
|
batch_size = kwargs.get("batch_size", 1)
|
|
# if kwargs.get("device", "cpu") == "cpu":
|
|
# batch_size = 1
|
|
|
|
key_list, data_list = prepare_data_iterator(
|
|
input, input_len=input_len, data_type=kwargs.get("data_type", None), key=key
|
|
)
|
|
|
|
speed_stats = {}
|
|
asr_result_list = []
|
|
num_samples = len(data_list)
|
|
disable_pbar = self.kwargs.get("disable_pbar", False)
|
|
pbar = (
|
|
tqdm(colour="blue", total=num_samples, dynamic_ncols=True) if not disable_pbar else None
|
|
)
|
|
time_speech_total = 0.0
|
|
time_escape_total = 0.0
|
|
for beg_idx in range(0, num_samples, batch_size):
|
|
end_idx = min(num_samples, beg_idx + batch_size)
|
|
data_batch = data_list[beg_idx:end_idx]
|
|
key_batch = key_list[beg_idx:end_idx]
|
|
batch = {"data_in": data_batch, "key": key_batch}
|
|
|
|
if (end_idx - beg_idx) == 1 and kwargs.get("data_type", None) == "fbank": # fbank
|
|
batch["data_in"] = data_batch[0]
|
|
batch["data_lengths"] = input_len
|
|
|
|
time1 = time.perf_counter()
|
|
with torch.no_grad():
|
|
res = model.inference(**batch, **kwargs)
|
|
if isinstance(res, (list, tuple)):
|
|
results = res[0] if len(res) > 0 else [{"text": ""}]
|
|
meta_data = res[1] if len(res) > 1 else {}
|
|
time2 = time.perf_counter()
|
|
|
|
asr_result_list.extend(results)
|
|
|
|
# batch_data_time = time_per_frame_s * data_batch_i["speech_lengths"].sum().item()
|
|
batch_data_time = meta_data.get("batch_data_time", -1)
|
|
time_escape = time2 - time1
|
|
speed_stats["load_data"] = meta_data.get("load_data", 0.0)
|
|
speed_stats["extract_feat"] = meta_data.get("extract_feat", 0.0)
|
|
speed_stats["forward"] = f"{time_escape:0.3f}"
|
|
speed_stats["batch_size"] = f"{len(results)}"
|
|
speed_stats["rtf"] = f"{(time_escape) / batch_data_time:0.3f}"
|
|
description = f"{speed_stats}, "
|
|
if pbar:
|
|
pbar.update(end_idx - beg_idx)
|
|
pbar.set_description(description)
|
|
if progress_callback:
|
|
try:
|
|
progress_callback(end_idx, num_samples)
|
|
except Exception as e:
|
|
logging.error(f"progress_callback error: {e}")
|
|
time_speech_total += batch_data_time
|
|
time_escape_total += time_escape
|
|
|
|
if pbar:
|
|
# pbar.update(1)
|
|
pbar.set_description(f"rtf_avg: {time_escape_total/time_speech_total:0.3f}")
|
|
|
|
device = next(model.parameters()).device
|
|
if device.type == "cuda":
|
|
with torch.cuda.device(device):
|
|
torch.cuda.empty_cache()
|
|
return asr_result_list
|
|
|
|
def inference_with_vad(self, input, input_len=None, **cfg):
|
|
"""Run ASR with VAD segmentation, punctuation, and optional speaker diarization.
|
|
|
|
Pipeline:
|
|
1. VAD: Segment audio into speech regions
|
|
2. ASR: Recognize each segment (sorted by length for efficient batching)
|
|
3. Timestamp merge: Combine per-segment timestamps with VAD offsets
|
|
4. Punctuation: Add punctuation to combined text (if punc_model configured)
|
|
5. Speaker diarization: Cluster speaker embeddings and assign labels (if spk_model configured)
|
|
|
|
Args:
|
|
input: Audio file path, URL, or numpy array.
|
|
input_len: Not used (kept for interface consistency).
|
|
**cfg: Runtime parameters (same as generate()).
|
|
|
|
Returns:
|
|
list[dict]: Results with fields: key, text, timestamp, sentence_info, raw_text.
|
|
"""
|
|
self._reset_runtime_configs()
|
|
if self.spk_model is not None and "output_timestamp" not in cfg:
|
|
cfg["output_timestamp"] = True
|
|
cfg["return_time_stamps"] = True
|
|
kwargs = self.kwargs
|
|
# step.1: compute the vad model
|
|
deep_update(self.vad_kwargs, cfg)
|
|
beg_vad = time.time()
|
|
res = self.inference(
|
|
input, input_len=input_len, model=self.vad_model, kwargs=self.vad_kwargs, **cfg
|
|
)
|
|
end_vad = time.time()
|
|
|
|
# FIX(gcf): concat the vad clips for sense vocie model for better aed
|
|
if cfg.get("merge_vad", False):
|
|
for i in range(len(res)):
|
|
res[i]["value"] = merge_vad(
|
|
res[i]["value"], kwargs.get("merge_length_s", 15) * 1000
|
|
)
|
|
|
|
# step.2 compute asr model
|
|
model = self.model
|
|
deep_update(kwargs, cfg)
|
|
batch_size = max(int(kwargs.get("batch_size_s", 300)) * 1000, 1)
|
|
batch_size_threshold_ms = int(kwargs.get("batch_size_threshold_s", 60)) * 1000
|
|
kwargs["batch_size"] = batch_size
|
|
|
|
key_list, data_list = prepare_data_iterator(
|
|
input, input_len=input_len, data_type=kwargs.get("data_type", None)
|
|
)
|
|
results_ret_list = []
|
|
time_speech_total_all_samples = 1e-6
|
|
|
|
beg_total = time.time()
|
|
pbar_total = (
|
|
tqdm(colour="red", total=len(res), dynamic_ncols=True)
|
|
if not kwargs.get("disable_pbar", False)
|
|
else None
|
|
)
|
|
for i in range(len(res)):
|
|
key = res[i]["key"]
|
|
vadsegments = res[i]["value"]
|
|
input_i = data_list[i]
|
|
fs = kwargs["frontend"].fs if hasattr(kwargs["frontend"], "fs") else 16000
|
|
speech = load_audio_text_image_video(input_i, fs=fs, audio_fs=kwargs.get("fs", 16000))
|
|
speech_lengths = len(speech)
|
|
n = len(vadsegments)
|
|
data_with_index = [(vadsegments[i], i) for i in range(n)]
|
|
sorted_data = sorted(data_with_index, key=lambda x: x[0][1] - x[0][0])
|
|
results_sorted = []
|
|
|
|
if not len(sorted_data):
|
|
results_ret_list.append({"key": key, "text": "", "timestamp": []})
|
|
logging.info("decoding, utt: {}, empty speech".format(key))
|
|
continue
|
|
|
|
if len(sorted_data) > 0 and len(sorted_data[0]) > 0:
|
|
batch_size = max(batch_size, sorted_data[0][0][1] - sorted_data[0][0][0])
|
|
|
|
if kwargs["device"] == "cpu":
|
|
batch_size = 0
|
|
|
|
beg_idx = 0
|
|
beg_asr_total = time.time()
|
|
time_speech_total_per_sample = speech_lengths / 16000
|
|
time_speech_total_all_samples += time_speech_total_per_sample
|
|
|
|
# pbar_sample = tqdm(colour="blue", total=n, dynamic_ncols=True)
|
|
|
|
all_segments = []
|
|
max_len_in_batch = 0
|
|
end_idx = 1
|
|
for j, _ in enumerate(range(0, n)):
|
|
# pbar_sample.update(1)
|
|
sample_length = sorted_data[j][0][1] - sorted_data[j][0][0]
|
|
potential_batch_length = max(max_len_in_batch, sample_length) * (j + 1 - beg_idx)
|
|
# batch_size_ms_cum += sorted_data[j][0][1] - sorted_data[j][0][0]
|
|
if (
|
|
j < n - 1
|
|
and sample_length < batch_size_threshold_ms
|
|
and potential_batch_length < batch_size
|
|
):
|
|
max_len_in_batch = max(max_len_in_batch, sample_length)
|
|
end_idx += 1
|
|
continue
|
|
|
|
speech_j, speech_lengths_j = slice_padding_audio_samples(
|
|
speech, speech_lengths, sorted_data[beg_idx:end_idx]
|
|
)
|
|
results = self.inference(
|
|
speech_j, input_len=None, model=model, kwargs=kwargs, **cfg
|
|
)
|
|
if self.spk_model is not None:
|
|
# compose vad segments: [[start_time_sec, end_time_sec, speech], [...]]
|
|
for _b in range(len(speech_j)):
|
|
vad_segments = [
|
|
[
|
|
sorted_data[beg_idx:end_idx][_b][0][0] / 1000.0,
|
|
sorted_data[beg_idx:end_idx][_b][0][1] / 1000.0,
|
|
np.array(speech_j[_b]),
|
|
]
|
|
]
|
|
segments = sv_chunk(vad_segments)
|
|
all_segments.extend(segments)
|
|
speech_b = [i[2] for i in segments]
|
|
spk_res = self.inference(
|
|
speech_b, input_len=None, model=self.spk_model, kwargs=kwargs, **cfg
|
|
)
|
|
spk_embs = torch.cat([r["spk_embedding"] for r in spk_res], dim=0)
|
|
results[_b]["spk_embedding"] = spk_embs
|
|
beg_idx = end_idx
|
|
end_idx += 1
|
|
max_len_in_batch = sample_length
|
|
if len(results) < 1:
|
|
continue
|
|
results_sorted.extend(results)
|
|
|
|
# end_asr_total = time.time()
|
|
# time_escape_total_per_sample = end_asr_total - beg_asr_total
|
|
# pbar_sample.update(1)
|
|
# pbar_sample.set_description(f"rtf_avg_per_sample: {time_escape_total_per_sample / time_speech_total_per_sample:0.3f}, "
|
|
# f"time_speech_total_per_sample: {time_speech_total_per_sample: 0.3f}, "
|
|
# f"time_escape_total_per_sample: {time_escape_total_per_sample:0.3f}")
|
|
|
|
if len(results_sorted) != n:
|
|
results_ret_list.append({"key": key, "text": "", "timestamp": []})
|
|
logging.info("decoding, utt: {}, empty result".format(key))
|
|
continue
|
|
restored_data = [0] * n
|
|
for j in range(n):
|
|
index = sorted_data[j][1]
|
|
restored_data[index] = results_sorted[j]
|
|
result = {}
|
|
|
|
# results combine for texts, timestamps, speaker embeddings and others
|
|
# TODO: rewrite for clean code
|
|
for j in range(n):
|
|
for k, v in restored_data[j].items():
|
|
if k.startswith("timestamp"):
|
|
if k not in result:
|
|
result[k] = []
|
|
for t in restored_data[j][k]:
|
|
if isinstance(t, dict):
|
|
t["start_time"] = (
|
|
float(t["start_time"]) * 1000 + int(vadsegments[j][0])
|
|
) / 1000
|
|
t["end_time"] = (
|
|
float(t["end_time"]) * 1000 + int(vadsegments[j][0])
|
|
) / 1000
|
|
else:
|
|
t[0] = int(t[0]) + int(vadsegments[j][0])
|
|
t[1] = int(t[1]) + int(vadsegments[j][0])
|
|
result[k].extend(restored_data[j][k])
|
|
elif k == "spk_embedding":
|
|
if k not in result:
|
|
result[k] = restored_data[j][k]
|
|
else:
|
|
result[k] = torch.cat([result[k], restored_data[j][k]], dim=0)
|
|
elif "text" in k:
|
|
if k not in result:
|
|
result[k] = restored_data[j][k]
|
|
else:
|
|
result[k] += " " + restored_data[j][k]
|
|
else:
|
|
if k not in result:
|
|
result[k] = restored_data[j][k]
|
|
else:
|
|
result[k] += restored_data[j][k]
|
|
|
|
# Convert dict-format timestamps (Fun-ASR-Nano) to list-format for downstream compatibility
|
|
if "timestamps" in result and "timestamp" not in result:
|
|
result["timestamp"] = [
|
|
[int(t["start_time"] * 1000), int(t["end_time"] * 1000)]
|
|
for t in result["timestamps"]
|
|
]
|
|
|
|
if not len(result["text"].strip()):
|
|
continue
|
|
return_raw_text = kwargs.get("return_raw_text", False)
|
|
# step.3 compute punc model
|
|
raw_text = None
|
|
punc_res = None
|
|
if self.punc_model is not None and "timestamps" not in result:
|
|
deep_update(self.punc_kwargs, cfg)
|
|
punc_res = self.inference(
|
|
result["text"], model=self.punc_model, kwargs=self.punc_kwargs, **cfg
|
|
)
|
|
raw_text = copy.copy(result["text"])
|
|
if return_raw_text:
|
|
result["raw_text"] = raw_text
|
|
result["text"] = punc_res[0]["text"]
|
|
|
|
# speaker embedding cluster after resorted
|
|
if self.spk_model is not None and kwargs.get("return_spk_res", True):
|
|
if raw_text is None and self.spk_mode == "punc_segment":
|
|
logging.warning("punc_model is missing, falling back to vad_segment mode for speaker diarization.")
|
|
self.spk_mode = "vad_segment"
|
|
elif raw_text is None:
|
|
logging.error("Missing punc_model, which is required by spk_model.")
|
|
all_segments = sorted(all_segments, key=lambda x: x[0])
|
|
spk_embedding = result["spk_embedding"]
|
|
labels = self.cb_model(
|
|
spk_embedding.cpu(), oracle_num=kwargs.get("preset_spk_num", None)
|
|
)
|
|
# del result['spk_embedding']
|
|
# postprocess expects np.ndarray embeddings (per its type hint).
|
|
spk_embedding_np = spk_embedding.detach().cpu().numpy()
|
|
if kwargs.get("return_spk_center", False):
|
|
sv_output, spk_center = postprocess(
|
|
all_segments, None, labels, spk_embedding_np, return_spk_center=True
|
|
)
|
|
# Per-speaker ERes2NetV2 centroids, indexed by the `spk` id in
|
|
# sentence_info. Kept on the result for downstream voiceprint use
|
|
# (the per-chunk spk_embedding below is still deleted to keep output small).
|
|
result["spk_embedding_center"] = spk_center
|
|
else:
|
|
sv_output = postprocess(all_segments, None, labels, spk_embedding_np)
|
|
if self.spk_mode == "punc_segment" and "timestamp" not in result and "timestamps" not in result:
|
|
logging.warning("No timestamps in ASR result (e.g. SenseVoice), falling back to vad_segment mode for speaker diarization.")
|
|
self.spk_mode = "vad_segment"
|
|
if self.spk_mode == "vad_segment": # recover sentence_list
|
|
sentence_list = []
|
|
for rest, vadsegment in zip(restored_data, vadsegments):
|
|
if "timestamp" in rest:
|
|
ts = rest["timestamp"]
|
|
elif "timestamps" in rest:
|
|
ts = [
|
|
[int(t["start_time"] * 1000), int(t["end_time"] * 1000)]
|
|
for t in rest["timestamps"]
|
|
]
|
|
else:
|
|
logging.error("No timestamp found in ASR result. Speaker diarization relies on timestamps.")
|
|
ts = []
|
|
sentence_list.append(
|
|
{
|
|
"start": vadsegment[0],
|
|
"end": vadsegment[1],
|
|
"sentence": rest["text"],
|
|
"timestamp": ts,
|
|
}
|
|
)
|
|
elif self.spk_mode == "punc_segment":
|
|
if "timestamp" not in result:
|
|
logging.error(
|
|
"Only 'iic/speech_paraformer-large-vad-punc_asr_nat-zh-cn-16k-common-vocab8404-pytorch' \
|
|
and 'iic/speech_seaco_paraformer_large_asr_nat-zh-cn-16k-common-vocab8404-pytorch'\
|
|
can predict timestamp, and speaker diarization relies on timestamps."
|
|
)
|
|
if punc_res is None:
|
|
logging.error(
|
|
"Missing punc_model, which is required for punc_segment speaker diarization."
|
|
)
|
|
sentence_list = []
|
|
elif kwargs.get("en_post_proc", False):
|
|
sentence_list = timestamp_sentence_en(
|
|
punc_res[0]["punc_array"],
|
|
result["timestamp"],
|
|
raw_text,
|
|
return_raw_text=return_raw_text,
|
|
)
|
|
else:
|
|
sentence_list = timestamp_sentence(
|
|
punc_res[0]["punc_array"],
|
|
result["timestamp"],
|
|
raw_text,
|
|
return_raw_text=return_raw_text,
|
|
)
|
|
distribute_spk(sentence_list, sv_output)
|
|
result["sentence_info"] = sentence_list
|
|
elif kwargs.get("sentence_timestamp", False):
|
|
if not len(result["text"].strip()):
|
|
sentence_list = []
|
|
elif punc_res is None:
|
|
logging.warning(
|
|
"punc_model is required for sentence_timestamp, skipping sentence segmentation."
|
|
)
|
|
sentence_list = []
|
|
else:
|
|
if kwargs.get("en_post_proc", False):
|
|
sentence_list = timestamp_sentence_en(
|
|
punc_res[0]["punc_array"],
|
|
result["timestamp"],
|
|
raw_text,
|
|
return_raw_text=return_raw_text,
|
|
)
|
|
else:
|
|
sentence_list = timestamp_sentence(
|
|
punc_res[0]["punc_array"],
|
|
result["timestamp"],
|
|
raw_text,
|
|
return_raw_text=return_raw_text,
|
|
)
|
|
result["sentence_info"] = sentence_list
|
|
if "spk_embedding" in result:
|
|
del result["spk_embedding"]
|
|
|
|
result["key"] = key
|
|
results_ret_list.append(result)
|
|
end_asr_total = time.time()
|
|
time_escape_total_per_sample = end_asr_total - beg_asr_total
|
|
if pbar_total:
|
|
pbar_total.update(1)
|
|
pbar_total.set_description(
|
|
f"rtf_avg: {time_escape_total_per_sample / time_speech_total_per_sample:0.3f}, "
|
|
f"time_speech: {time_speech_total_per_sample: 0.3f}, "
|
|
f"time_escape: {time_escape_total_per_sample:0.3f}"
|
|
)
|
|
|
|
# end_total = time.time()
|
|
# time_escape_total_all_samples = end_total - beg_total
|
|
# print(f"rtf_avg_all: {time_escape_total_all_samples / time_speech_total_all_samples:0.3f}, "
|
|
# f"time_speech_all: {time_speech_total_all_samples: 0.3f}, "
|
|
# f"time_escape_all: {time_escape_total_all_samples:0.3f}")
|
|
return results_ret_list
|
|
|
|
def export(self, input=None, **cfg):
|
|
"""Export model to ONNX format.
|
|
|
|
Creates a deep copy of the model to isolate ONNX operator monkey-patching,
|
|
then runs torch.onnx.export. The original model remains usable after export.
|
|
|
|
Args:
|
|
input: Sample input for tracing (auto-generated if None).
|
|
**cfg: Export parameters:
|
|
- type (str): Export format, "onnx" (default).
|
|
- quantize (bool): Whether to quantize the model.
|
|
- device (str): Device for export.
|
|
|
|
Returns:
|
|
str: Path to the exported model directory.
|
|
"""
|
|
"""
|
|
|
|
:param input:
|
|
:param type:
|
|
:param quantize:
|
|
:param fallback_num:
|
|
:param calib_num:
|
|
:param opset_version:
|
|
:param cfg:
|
|
:return:
|
|
"""
|
|
|
|
device = cfg.get("device", "cpu")
|
|
|
|
# 对模型进行深拷贝,隔离 ONNX 算子替换(Monkey-patching)对原模型的破坏
|
|
# Implement deep copy of the model to isolate ONNX operator monkey-patching
|
|
# and prevent corruption of the original model
|
|
model = copy.deepcopy(self.model).to(device=device)
|
|
|
|
# 对配置参数进行深拷贝,隔离 deep_update 和 del 的引用污染
|
|
# Implement deep copy of configuration parameters to isolate reference pollution caused by deep_update and del.
|
|
kwargs = copy.deepcopy(self.kwargs)
|
|
|
|
deep_update(kwargs, cfg)
|
|
kwargs["device"] = device
|
|
|
|
# Safely delete keys that may cause issues during export
|
|
if "model" in kwargs:
|
|
del kwargs["model"]
|
|
|
|
model.eval()
|
|
|
|
type = kwargs.get("type", "onnx")
|
|
|
|
key_list, data_list = prepare_data_iterator(
|
|
input, input_len=None, data_type=kwargs.get("data_type", None), key=None
|
|
)
|
|
|
|
with torch.no_grad():
|
|
# 这里的导出操作只会魔改 model 副本,原实例的 self.model 依然是纯洁的 PyTorch 图
|
|
# This export operation only mutates the model copy;
|
|
# the original self.model instance remains an intact PyTorch graph.
|
|
export_dir = export_utils.export(model=model, data_in=data_list, **kwargs)
|
|
|
|
return export_dir
|
|
|
|
def _store_base_configs(self):
|
|
"""Snapshot base kwargs for all submodules to allow reset before inference."""
|
|
baseline = {}
|
|
for name in dir(self):
|
|
if not name.endswith("kwargs"):
|
|
continue
|
|
value = getattr(self, name, None)
|
|
if isinstance(value, dict):
|
|
baseline[name] = copy.deepcopy(value)
|
|
# include primary kwargs explicitly
|
|
baseline["kwargs"] = copy.deepcopy(self.kwargs)
|
|
self._base_kwargs_map = baseline
|
|
|
|
_IMMUTABLE_KWARGS_KEYS = frozenset([
|
|
"token_list", "tokenizer", "frontend", "model", "init_param", "model_path",
|
|
])
|
|
|
|
def _reset_runtime_configs(self):
|
|
"""Ensure runtime kwargs reset to baseline defaults before inference."""
|
|
base_map = getattr(self, "_base_kwargs_map", None)
|
|
if not base_map:
|
|
return
|
|
|
|
for name, base in base_map.items():
|
|
restored = {}
|
|
for k, v in base.items():
|
|
if k in self._IMMUTABLE_KWARGS_KEYS or not isinstance(v, (dict, list)):
|
|
restored[k] = v
|
|
else:
|
|
restored[k] = copy.deepcopy(v)
|
|
setattr(self, name, restored)
|
|
|
|
ncpu = _resolve_ncpu(self.kwargs, 4)
|
|
self.kwargs["ncpu"] = ncpu
|
|
for name, value in base_map.items():
|
|
if name == "kwargs":
|
|
continue
|
|
config = getattr(self, name, None)
|
|
if isinstance(config, dict):
|
|
config.setdefault("ncpu", ncpu)
|
|
if torch.get_num_threads() != ncpu:
|
|
torch.set_num_threads(ncpu)
|