Cette rubrique présente les interfaces principales et les paramètres de requête pour appeler les modèles de la série Qwen-TTS-Realtime avec le SDK DashScope pour Java.
Prérequis
DashScope Java SDK version 2.22.7 ou ultérieure requis.
Démarrage rapide
- Server commit mode
- Commit mode
appendText()Paramètres de requête
Configurez les paramètres suivants via les méthodes chaînées ou les setters d'un objet QwenTtsRealtimeParam, puis transmettez cet objet au constructeur QwenTtsRealtime.
Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
model | String | Oui | Nom du modèle (voir Modèles pris en charge). |
url | String | Oui | Chine (Pékin) : Singapour : |
QwenTtsRealtimeConfig, puis passez cet objet à la méthode updateSession.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| voice | String | Oui | Voix utilisée pour la synthèse vocale. Pour plus d'informations, voir Liste des voix Qwen-TTS. |
| languageType | String | Non | Spécifie la langue de l'audio synthétisé. La valeur par défaut est Auto.
|
| mode | String | Non | Mode d'interaction. Valeurs valides :
|
| format | String | Non | Format de sortie audio du modèle.Formats pris en charge :
|
| sampleRate | int | Non | Fréquence d'échantillonnage de la sortie audio du modèle, exprimée en Hz.Fréquences d'échantillonnage prises en charge :
|
| speechRate | float | Non | Vitesse de lecture de l'audio. Une valeur de 1,0 correspond à la vitesse normale. Une valeur inférieure à 1,0 ralentit la lecture, tandis qu'une valeur supérieure à 1,0 l'accélère.Valeur par défaut : 1,0.Plage valide : [0,5, 2,0]. |
| volume | int | Non | Volume de l'audio.Plage valide : [0, 100]. |
| pitchRate | float | Non | Hauteur tonale de l'audio synthétisé.Valeur par défaut : 1,0.Plage valide : [0,5, 2,0]. |
| bitRate | int | Non | Définit le débit binaire de l'audio en kbps. Un débit plus élevé améliore la qualité audio mais augmente la taille du fichier. Ce paramètre n'est disponible que si le format audio (response_format) est défini sur opus.Valeur par défaut : 128.Plage valide : [6, 510]. |
Référence de l’API
Classe QwenTtsRealtime
Importation :
| Méthode | Signature | Événements serveur | Description |
|---|---|---|---|
| connect | session.createdSession crééesession.updated Configuration de session mise à jour | Ouvre une connexion WebSocket vers le serveur. | |
| updateSession | session.updatedConfiguration de session mise à jour | Met à jour la configuration de la session. Voir Paramètres de requête.Après la connexion, le serveur renvoie les configurations d'entrée et de sortie par défaut pour la session. Appelez cette méthode immédiatement après connect() pour remplacer les valeurs par défaut.Le serveur valide les paramètres lors de la réception d'un événement session.update. Si un paramètre est invalide, le serveur renvoie une erreur. Dans le cas contraire, il met à jour la configuration de la session côté serveur. | |
| appendText | Aucun | Ajoute un segment de texte au tampon d'entrée côté serveur. Le tampon stocke le texte jusqu'à sa soumission.
| |
| clearAppendedText | input_text_buffer.clearedEfface le texte reçu par le serveur | Efface tout le texte présent dans le tampon d'entrée côté serveur. | |
| commit | input_text_buffer.committedValide le texte et déclenche la synthèse vocaleresponse.output_item.added Nouveau contenu de sortie apparu dans la réponseresponse.content_part.added Nouveau contenu de sortie ajouté à l'élément de message de l'assistantresponse.audio.delta Génération incrémentielle de l'audio par le modèleresponse.audio.done Génération audio terminéeresponse.content_part.done Flux audio du message de l'assistant terminéresponse.output_item.done Flux complet de l'élément de sortie du message de l'assistant terminéresponse.done Réponse terminée | Valide le texte précédemment ajouté au tampon côté serveur et synthétise immédiatement l'ensemble du texte. Renvoie une erreur si le tampon est vide.
| |
| finish | session.finishedRéponse terminée | Arrête la tâche en cours. | |
| close | Aucun | Ferme la connexion. | |
| getSessionId | Aucun | Renvoie l'ID de session de la tâche en cours. | |
| getResponseId | Aucun | Renvoie l'ID de la réponse la plus récente. | |
| getFirstAudioDelay | Aucun | Renvoie la latence du premier paquet audio en millisecondes. |
Interface de rappel (QwenTtsRealtimeCallback)
| Méthode | Paramètres | Valeur de retour | Description |
|---|---|---|---|
| Aucun | Aucun | Appelé immédiatement après l'établissement de la connexion WebSocket. | |
| message : événement de réponse côté serveur. | Aucun | Appelé lorsque le serveur envoie un événement, y compris les réponses aux appels API et l'audio généré par le modèle. Voir Événements côté serveur. | |
| code : code d'état de fermeture WebSocket.reason : motif de fermeture. | Aucun | Appelé après la fermeture de la connexion par le serveur. |