Skip to main content

Qwen-Audio-ASR-Filetrans Node.js SDK

Utilisez le SDK vocal Node.js pour envoyer des URL audio à Qwen-Audio-ASR-Filetrans, interroger les tâches asynchrones et télécharger les transcriptions.

Installer le SDK

Nécessite Node.js 18 ou ultérieur. Téléchargez le SDK 0.1.0, puis exécutez dans votre projet :
npm install ./dashscope-sdk-nodejs-0.1.0.tgz

Démarrage rapide

Obtenez une clé API dans la console et définissez-la dans la variable d’environnement DASHSCOPE_API_KEY. Enregistrez l’exemple dans example.mjs, puis exécutez node example.mjs.
import { TranscriptionClient } from 'dashscope-sdk-nodejs/asr'

const client = new TranscriptionClient({
  apiKey: process.env.DASHSCOPE_API_KEY,
  workspaceId: process.env.DASHSCOPE_WORKSPACE_ID,
  baseUrl: 'dashscope-intl.aliyuncs.com',
  model: 'qwen-audio-3.1-asr-flash-filetrans',
})
const job = await client.transcribe(
  'https://dashscope.oss-cn-beijing.aliyuncs.com/audios/welcome.mp3',
)
for (const result of job.results) {
  if (result.subtaskStatus === 'SUCCEEDED') {
    console.log('Transcript:', result.text)
  } else {
    console.error(result.code, result.message)
    process.exitCode = 1
  }
}

Référence API

Options du constructeur

Options du constructeur de TranscriptionClient :
ParamètreTypeObligatoireDescription
apiKeystringNonClé API. Utilise DASHSCOPE_API_KEY par défaut.
workspaceIdstringNonID de l’espace de travail. Utilise DASHSCOPE_WORKSPACE_ID par défaut.
baseUrlstringNonDéfinissez l’hôte sur dashscope-intl.aliyuncs.com (Singapour).
modelstringNonID du modèle. Par défaut : qwen-audio-3.1-asr-flash-filetrans.
pollIntervalMsnumberNonIntervalle de polling. Par défaut : 3000 ms.
pollTimeoutMsnumberNonDélai de polling en ms. Par défaut : 600000.
requestTimeoutMsnumberNonDélai de requête HTTP en ms. Par défaut : 30000 ; 0 désactive le délai individuel.

Paramètres de transcription

Le deuxième argument de transcribe() et submitTask() est parameters ; le troisième accepte context. Consultez l’API HTTP pour les détails.
ParamètreTypeObligatoireDescription
fileUrlsstring | string[]OuiURL audio publique ; un fichier par tâche.
parameters.keep_dialectbooleanNonConserve les expressions dialectales. Par défaut : false.
parameters.vocabulary_idstringNonID du vocabulaire précompilé.
parameters.vocabularyRecord<string, number>NonVocabulaire instantané : mots en clés, poids dans [1,5] ou 50 en valeurs.
parameters.channel_idnumber[]NonIndices des canaux audio. Par défaut : [0].
parameters.special_word_filterstring | Record<string, unknown>NonConfiguration du filtre de mots sensibles sous forme de chaîne JSON ou d’objet.
parameters.diarization_enabledbooleanNonDiarisation des locuteurs pour l’audio mono. Par défaut : false.
parameters.speaker_countnumberNonNombre attendu de locuteurs : [2,100]. Nécessite la diarisation.
parameters.language_hintsstring[]NonIndications de langue de reconnaissance. Les 4 premières valeurs au plus sont prises en compte. Détection automatique si omises.
callOpts.context / submitOpts.contextAsrContextMessage[]NonContexte de reconnaissance. Format : { role, content: [{ type: "input_text", text }] }, avec role valant user ou assistant. Au plus 5 messages par rôle et moins de 400 caractères au total, dans l’ordre des tours.
callOpts.onProgress(status: string, response: QueryTaskResponse) => voidNonCallback de progression avec status et response brut.

Méthodes principales

MéthodeValeur de retourDescription
transcribe(fileUrls: string | string[], parameters?: TranscriptionParameters, callOpts?: TranscribeCallOptions)Promise<TranscriptionJobResult>Soumet l’audio, interroge et télécharge les résultats. callOpts accepte le contexte et un callback de progression.
submitTask(fileUrls: string | string[], parameters?: TranscriptionParameters, submitOpts?: TranscriptionSubmitOptions)Promise<{ taskId: string; taskStatus: string }>Soumet la tâche et renvoie son ID et son état initial. Définissez le contexte avec submitOpts.context.
fetchTask(taskId: string, requestTimeoutMs?: number)Promise<QueryTaskResponse>Interroge une fois la tâche pour son état et les URL de résultats.

Valeurs de retour

ChampTypeDescription
taskIdstringID de tâche.
taskStatusstringÉtat de la tâche.
resultsFileTranscriptionResult[]Résultats par fichier avec subtaskStatus, text et transcription ; les échecs incluent code et message.
usageRecognitionUsage | undefinedUtilisation renvoyée par le service.
rawQueryTaskResponseRéponse brute de la requête de tâche.