@huggingface/transformers
Version:
State-of-the-art Machine Learning for the web. Run 🤗 Transformers directly in your browser, with no need for a server!
99 lines • 4.55 kB
TypeScript
declare const AudioClassificationPipeline_base: new (options: AudioPipelineConstructorArgs) => AudioClassificationPipelineType;
/**
* @typedef {import('./_base.js').AudioPipelineConstructorArgs} AudioPipelineConstructorArgs
* @typedef {import('./_base.js').Disposable} Disposable
* @typedef {import('./_base.js').AudioInput} AudioInput
*/
/**
* @typedef {Object} AudioClassificationSingle
* @property {string} label The label predicted.
* @property {number} score The corresponding probability.
* @typedef {AudioClassificationSingle[]} AudioClassificationOutput
*
* @typedef {Object} AudioClassificationPipelineOptions Parameters specific to audio classification pipelines.
* @property {number} [top_k=5] The number of top labels that will be returned by the pipeline.
* If the provided number is `null` or higher than the number of labels available in the model configuration,
* it will default to the number of labels.
*
* @typedef {AudioPipelineConstructorArgs & AudioClassificationPipelineCallback & Disposable} AudioClassificationPipelineType
*/
/**
* @template T
* @typedef {T extends AudioInput[] ? AudioClassificationOutput[] : AudioClassificationOutput} AudioClassificationPipelineResult
*/
/**
* @typedef {<T extends AudioInput | AudioInput[]>(audio: T, options?: AudioClassificationPipelineOptions) => Promise<AudioClassificationPipelineResult<T>>} AudioClassificationPipelineCallback
*/
/**
* Audio classification pipeline using any `AutoModelForAudioClassification`.
* This pipeline predicts the class of a raw waveform or an audio file.
*
* **Example:** Perform audio classification with `Xenova/wav2vec2-large-xlsr-53-gender-recognition-librispeech`.
* ```javascript
* import { pipeline } from '@huggingface/transformers';
*
* const classifier = await pipeline('audio-classification', 'Xenova/wav2vec2-large-xlsr-53-gender-recognition-librispeech');
* const audio = 'https://huggingface.co/datasets/Xenova/transformers.js-docs/resolve/main/jfk.wav';
* const output = await classifier(audio);
* // [
* // { label: 'male', score: 0.9981542229652405 },
* // { label: 'female', score: 0.001845747814513743 }
* // ]
* ```
*
* **Example:** Perform audio classification with `Xenova/ast-finetuned-audioset-10-10-0.4593` and return top 4 results.
* ```javascript
* import { pipeline } from '@huggingface/transformers';
*
* const classifier = await pipeline('audio-classification', 'Xenova/ast-finetuned-audioset-10-10-0.4593');
* const audio = 'https://huggingface.co/datasets/Xenova/transformers.js-docs/resolve/main/cat_meow.wav';
* const output = await classifier(audio, { top_k: 4 });
* // [
* // { label: 'Meow', score: 0.5617874264717102 },
* // { label: 'Cat', score: 0.22365376353263855 },
* // { label: 'Domestic animals, pets', score: 0.1141069084405899 },
* // { label: 'Animal', score: 0.08985692262649536 },
* // ]
* ```
*/
export class AudioClassificationPipeline extends AudioClassificationPipeline_base {
_call(audio: any, { top_k }?: {
top_k?: number;
}): Promise<{
label: string;
score: number;
}[] | {
label: string;
score: number;
}[][]>;
}
export type AudioPipelineConstructorArgs = import("./_base.js").AudioPipelineConstructorArgs;
export type Disposable = import("./_base.js").Disposable;
export type AudioInput = import("./_base.js").AudioInput;
export type AudioClassificationSingle = {
/**
* The label predicted.
*/
label: string;
/**
* The corresponding probability.
*/
score: number;
};
export type AudioClassificationOutput = AudioClassificationSingle[];
/**
* Parameters specific to audio classification pipelines.
*/
export type AudioClassificationPipelineOptions = {
/**
* The number of top labels that will be returned by the pipeline.
* If the provided number is `null` or higher than the number of labels available in the model configuration,
* it will default to the number of labels.
*/
top_k?: number;
};
export type AudioClassificationPipelineType = AudioPipelineConstructorArgs & AudioClassificationPipelineCallback & Disposable;
export type AudioClassificationPipelineResult<T> = T extends AudioInput[] ? AudioClassificationOutput[] : AudioClassificationOutput;
export type AudioClassificationPipelineCallback = <T extends AudioInput | AudioInput[]>(audio: T, options?: AudioClassificationPipelineOptions) => Promise<AudioClassificationPipelineResult<T>>;
export {};
//# sourceMappingURL=audio-classification.d.ts.map