Saltar a contenido

FunAudioLLMSenseVoiceSmall

FunASR

Runs SenseVoiceSmall's native SANM-CTC graph with language detection and word timestamps.

Automatic speech recognitionVoiceHub-nativesensevoice-smallParameters: Not reportedLanguages: zh, en +3Training: nativeLicense: Checkpoint-specific

Parameter metadata: Not reported: the audited metadata available for the registered default does not provide an exact parameter total.

Use this model Checkpoint
Resources
Paper Upstream GitHub VoiceHub source Open in Colab

Usage

Complete the VoiceHub installation once, then run this repository-authored example. Model pages intentionally contain no package-install command.

This example is maintained against VoiceHub's public API; it is not copied from an upstream demo or package README.

Model-specific path: Runs SenseVoiceSmall's native SANM-CTC graph with language detection and word timestamps.

Inputs and controls: This provider recognizes SenseVoiceSmall only; VAD, punctuation, and speaker models must be composed separately.

from pathlib import Path

from voicehub import AutoModelForSpeechRecognition

AUDIO_FILE = Path("speech.wav")
if not AUDIO_FILE.is_file():
    raise FileNotFoundError(AUDIO_FILE)

model = AutoModelForSpeechRecognition.from_pretrained(
    'FunAudioLLM/SenseVoiceSmall',
    model_type='asr_funasr',
    device="cuda",
    lazy_load=True,
)
output = model.transcribe(
    AUDIO_FILE,
    language="auto",
    return_timestamps="word",
)
print(output.text)
for segment in output.segments:
    print(segment.start, segment.end, segment.text, segment.confidence)

Use authorized recordings. Verify hardware needs and pin a revision in production.

Overview

asr_funasr is a VoiceHub automatic speech recognition integration. This page is generated from its registry contract. Open the asr_funasr Colab notebook.

Property Value
Task Automatic speech recognition
Architecture sensevoice-small
Runtime VoiceHub-native
Languages zh, en, ja, ko, yue
Capabilities automatic-speech-recognition, multilingual, timestamps, language-identification, emotion-recognition, audio-events, fine-tuning, safetensors, voicehub-native, native-runtime
Reusable components —
Normalized output ASROutput

Language support

Supported language abbreviations

zh, en, ja, ko, yue

Paper and GitHub

Configuration

Load configuration without constructing the model:

from voicehub import AutoConfig

config = AutoConfig.for_model('asr_funasr')
print(config.model_type)
Property Value
Canonical model type asr_funasr
Configuration class FunASRConfig
Architecture class FunASRForSpeechRecognition

Processing

Create the registered processor without allocating model weights:

from voicehub import AutoProcessor

processor = AutoProcessor.from_pretrained(
    'FunAudioLLM/SenseVoiceSmall',
    model_type='asr_funasr',
)
print(type(processor).__name__)

Inference

The Usage example returns ASROutput through AutoModelForSpeechRecognition.

Input and output contract

Property Value
Readiness integrated-raw
Data architecture ctc
Sample rate 16,000 Hz
Contract getter get_asr_dataset_spec('asr_funasr')
Variant Required fields One of Boundary Other rules
raw-audio language audio / audio_values / input_signal; text / transcription / transcript Source at most one: audio / audio_values / input_signal; text / transcription / transcript
sensevoice-feature-transcript features, language text / transcription / transcript Prepared at most one: text / transcription / transcript
sensevoice-model-ready features, feature_lengths, labels, label_lengths — Prepared —

SenseVoice CTC records with language, emotion, event, and ITN control. See the data workflow.

Training and optimization

Use available_optimization_passes() to discover reversible public passes. Unsupported runtime or hardware fails closed before mutation.

Training contract

Property Value
Support native
Family ctc
Recipe single-phase
Default phase speech_recognition
Training checkpoint FunAudioLLM/SenseVoiceSmall
Native training graph yes
Phase Kind Components Required inputs Loss keys
speech_recognition objective model features, feature_lengths, labels, label_lengths loss, ctc, rich

The integration accepts its declared source or prepared contract directly. Call model.validate_training_support() first, then follow the training workflow.

Checkpoints, provenance, license, and limitations

Property Value
Default checkpoint FunAudioLLM/SenseVoiceSmall
Hugging Face ID FunAudioLLM/SenseVoiceSmall
Repository availability verified through the Hugging Face model API on 2026-08-11; pin a revision before production use.
Checkpoint status Registry default; pin an immutable revision for production and reproducible evidence
Optional dependency extra Core package
Hardware and runtime Usage selects cuda; verify checkpoint-specific requirements
Real-checkpoint evidence Release evidence; a registry default alone is not execution evidence
Implementation voicehub.models.asr_native.funasr.FunASRForSpeechRecognition
Configuration voicehub.models.asr_native.configuration.FunASRConfig
Source provenance voicehub/architectures/sensevoice/SOURCE.json
License Checkpoint-specific

No VoiceHub-specific license override is registered. Verify the checkpoint and upstream source terms before use.

Confirm the checkpoint revision, access terms, provenance, and license.

Limitations

  • No integration-specific checkpoint limitation is registered. Verify the selected checkpoint revision and its documented runtime requirements.
  • Validate memory, precision, and optional dependencies on the target system.
  • Public optimizations fail closed when the runtime or hardware cannot satisfy their validation contract; an unavailable pass is not reported as applied.
  • Contract tests do not replace the linked released-checkpoint evidence.

Public API

Use the stable configuration, processor, and task-model facades below.

Configuration

FunASRConfig

View source

FunASRConfig(**config_kwargs)

Parameters

  • **config_kwargs — Configuration fields validated by FunASRConfig.

Model

FunASRForSpeechRecognition

View source

AutoModelForSpeechRecognition.from_pretrained(
    pretrained_model_name_or_path,
    *,
    model_type='asr_funasr',
    config=None,
    **model_kwargs,
)

Parameters

  • pretrained_model_name_or_path — Hub ID or compatible local directory.
  • model_type — Canonical model type; use 'asr_funasr'.
  • config — Optional preloaded FunASRConfig instance.
  • **model_kwargs — Model-specific loading arguments.
from voicehub import get_model_spec

spec = get_model_spec('asr_funasr')
print(spec.display_name, spec.task.value)
Purpose Public object
Discover get_model_spec('asr_funasr')
Load and run AutoModelForSpeechRecognition
Configure FunASRConfig
Process AutoProcessor
Model implementation FunASRForSpeechRecognition
Normalized output ASROutput
Training contract get_training_spec('asr_funasr')
Optimization lifecycle available_optimization_passes, apply_optimization_plan, optimization_manifest, restore_optimization_plan

See all model guides, inference, and the training matrix.