Cette rubrique détaille les paramètres et le fonctionnement de l'API HTTP de reconnaissance vocale en différé Qwen-Audio-ASR.
Pour connaître les prérequis d'entrée (formats audio pris en charge, limites de taille de fichier et de durée), consultez Spécifications audio.
En mode streaming, le client doit gérer les éléments suivants :
Endpoints du service
- Singapore
- China (Beijing)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generationRemplacez {WorkspaceId} par votre ID d'espace de travail réel.En-têtes de requête
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
Authorization | string | Oui | Jeton d'authentification au format Bearer <your_api_key>. Remplacez « <your_api_key> » par votre clé API réelle. |
Content-Type | string | Oui | Type MIME du corps de la requête. Valeur fixe : application/json. |
X-DashScope-SSE | string | Non | Détermine si les résultats en streaming sont demandés. Définissez ce paramètre sur enable pour demander le streaming SSE. Définissez-le sur disable ou omettez-le pour ne renvoyer que le résultat final.S’applique uniquement à qwen-audio-3.0-asr-flash : le streaming SSE est disponible uniquement pour les fichiers audio d’au moins 1 minute. |
Corps de la requête | Les exemples suivants utilisent la configuration de la région Singapore. Remplacez « {WorkspaceId} » par votre ID d'espace de travail réel. La configuration varie selon les régions, et la clé API de la région Singapore diffère de celle de la région Beijing.
|
modelstring(Obligatoire)Le nom du modèle. | |
inputobject(Obligatoire)Informations d'entrée.
Propriétés messages array(object)(Obligatoire)Liste des messages. Elle contient l'audio à reconnaître ainsi que, facultativement, un contexte de conversation améliorant la précision de la reconnaissance.
Propriétés role string(Obligatoire)Rôle du message. Valeurs valides :
array(object)(Obligatoire)Liste du contenu des messages.
Propriétés type string(Obligatoire)Type de contenu. Chaque requête nécessite au moins un message de type input_audio. Valeurs valides :
object(Conditionnellement obligatoire)Obligatoire lorsque type vaut input_audio.
Propriétés data string(Obligatoire)Données audio à reconnaître. Pour connaître les prérequis d'entrée (formats audio pris en charge, limites de taille de fichier et de durée), consultez Spécifications audio. Deux méthodes sont prises en charge :
https://example.com/audio/sample.wavExemple (Base64) : data:audio/wav;base64,{BASE64_ENCODED_DATA}string(Conditionnellement obligatoire)Lorsque type vaut input_text, saisissez les résultats de reconnaissance de la parole utilisateur des tours précédents ou une liste de mots spécifiques au domaine. Lorsque type vaut text, saisissez les réponses du grand modèle linguistique des tours précédents. La longueur du texte est mesurée en caractères, chaque caractère comptant pour 1. La longueur combinée des champs text dans tous les messages d'un même tour de contexte ne peut excéder 400 caractères. Tout excédent est tronqué par la fin. | |
parametersobject(Obligatoire)Paramètres du modèle.Le lissage du texte est désactivé par défaut et n’est pas encore disponible pour qwen-audio-3.0-asr-flash. qwen-audio-3.1-asr-flash prend en charge le lissage natif du texte.Lissage du texte : Pendant la transcription, le modèle supprime les mots de remplissage sans signification et les répétitions dues au bégaiement, traite les autocorrections, améliore les expressions orales et normalise la ponctuation et la mise en forme. Le résultat est plus concis, fluide et lisible, tout en préservant autant que possible l’intention finale et les informations essentielles du locuteur.
Propriétés speaker_diarization_enabled boolean (Facultatif)S’applique uniquement à qwen-audio-3.1-asr-flash.false. Avec true, la réponse utilise speaker_id pour distinguer les locuteurs et inclut output.sentences. Si elle est activée, keep_dialect et language_hints sont ignorés.keep_dialect boolean (Facultatif)S’applique uniquement à qwen-audio-3.1-asr-flash.false. Avec false, le dialecte est transcrit en mandarin standard ; avec true, les expressions dialectales sont conservées.formatstring(Obligatoire)Format audio. Définissez cette valeur pour qu'elle corresponde à votre format audio réel. Les valeurs prises en charge incluent wav, mp3 et opus. Pour plus de détails, consultez Spécifications audio.sample_ratestring(Facultatif)Fréquence d'échantillonnage audio, en Hz. Par exemple, 16000 correspond à une fréquence d'échantillonnage de 16 kHz. Pour plus de détails, consultez Spécifications audio.vocabulary_idstring(Facultatif)Identifiant d'une liste de mots-clés précompilée.Générez cet identifiant au préalable en appelant l'API de création de liste de mots-clés. Transmettez l'identifiant lors de la reconnaissance pour utiliser les mots-clés de la liste.Convient aux scénarios où le vocabulaire est connu et relativement stable, et où vous devez réutiliser la même liste de mots entre plusieurs requêtes.Pour plus de détails sur l'utilisation, consultez Mots-clés précompilés.vocabularyobject(Facultatif)Mots-clés instantanés.Transmis sous forme de paires clé-valeur, où la clé est le texte du mot-clé (string) et la valeur est le poids du mot-clé (integer). Aucune liste de mots-clés ne doit être créée au préalable. Le poids varie de [1, 5] ou est fixé à 50 : une valeur comprise dans [1, 5] augmente la probabilité que le modèle génère le mot à mesure que la valeur croît ; une valeur de 50 désigne un super mot-clé, ce qui améliore considérablement le rappel, mais le nombre de super mots-clés ne peut excéder 50.Adapté à l'optimisation temporaire de mots-clés au niveau de la session.Lorsqu'ils sont configurés conjointement avec des mots-clés précompilés, seuls les mots-clés instantanés prennent effet. Pour plus de détails sur l'utilisation, consultez Mots-clés instantanés.language_hints array[string](Facultatif)Les codes des langues à reconnaître. Si la langue est inconnue, omettez ce paramètre pour que le modèle la détecte automatiquement. Vous pouvez définir jusqu’à 4 valeurs. Au-delà, seules les 4 premières sont prises en compte.La spécification des codes de langue peut améliorer la précision de la reconnaissance.
Codes de langue pris en charge
qwen-audio-3.1-asr-flash prend également en charge les codes de langue suivants :
|
Corps de la réponse |
|
request_idstringIdentifiant unique de cette requête. | |
outputobjectRésultat de sortie.
Propriétés text stringTexte reconnu complet accumulé jusqu'à présent.sentences array[object]S’applique uniquement à qwen-audio-3.1-asr-flash.sentence.sentenceobjectDétails de la phrase en cours.
Propriétés speaker_id integer | nullS’applique uniquement à qwen-audio-3.1-asr-flash.null sinon.sentence_idintegerNuméro de la phrase, commençant à 1.sentence_endbooleanIndique s'il s'agit du résultat final pour la phrase. La valeur true signifie que la reconnaissance de la phrase est terminée.begin_timeintegerHeure de début de la phrase, en millisecondes.end_timeintegerHeure de fin de la phrase, en millisecondes. Renvoyé uniquement lorsque sentence_end vaut true.textstringTexte reconnu de la phrase en cours.channel_idintegerNuméro du canal, commençant à 0.wordsarrayListe des horodatages au niveau des mots.
Propriétés speaker_id integer | nullS’applique uniquement à qwen-audio-3.1-asr-flash.null sinon.textstringTexte du mot.begin_timeintegerHeure de début du mot, en millisecondes.end_timeintegerHeure de fin du mot, en millisecondes.punctuationstringSigne de ponctuation suivant le mot. Chaîne vide en l'absence de ponctuation.fixedbooleanIndique si le mot est stabilisé. La valeur false indique que l'horodatage du mot peut être ajusté dans les événements ultérieurs. | |
usageobjectInformations d'utilisation. Renvoyé uniquement lorsque sentence_end vaut true.
Propriétés duration integerDurée audio traitée, en secondes.input_tokens integerS’applique uniquement à qwen-audio-3.1-asr-flash.integerS’applique uniquement à qwen-audio-3.1-asr-flash.integerS’applique uniquement à qwen-audio-3.1-asr-flash.input_tokens et output_tokens. |
Logique de traitement des résultats de streaming SSE
En mode streaming, le client doit gérer les éléments suivants :
- Pour chaque événement SSE reçu, analysez le JSON contenu dans le champ
data. - Pour
qwen-audio-3.0-asr-flash, utilisezoutput.sentence.sentence_endpour déterminer si la phrase actuelle est terminée. Si la valeur esttrue, la reconnaissance est terminée et les horodatages des mots sont stabilisés ; le résultat peut être utilisé comme résultat final. Si elle estfalse, la reconnaissance est en cours et le texte ainsi que les horodatages peuvent être mis à jour dans les événements suivants. - Les informations
usagesont renvoyées uniquement dans les événements de fin de phrase et incluent la durée audio traitée. Pourqwen-audio-3.1-asr-flash, elles incluent également les nombres de tokens d’entrée, de sortie et totaux de la requête. Ce modèle est facturé selon l’utilisation des tokens.
qwen-audio-3.1-asr-flash sans diarisation, l’horodatage d’un mot devient définitif uniquement lorsque output.sentence.words[i].fixed vaut true. Avant cela, il peut changer. Si la diarisation est activée, lisez les résultats de la phrase actuelle et des précédentes dans output.sentences.