> ## Documentation Index > Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt > Use this file to discover all available pages before exploring further. # Qwen3 TTS VD > - Convertit du texte en audio vocal ; **doit obligatoirement utiliser un timbre personnalisé créé par [Qwen Voice Design](/fr/api-manual/audio-series/qwen-tts/qwen-voice-design)** ; les timbres système intégrés ne sont pas pris en charge - Flux d'utilisation : appelez d'abord `qwen-voice-design` pour créer un timbre → obtenez le nom `voice` → passez-le dans le paramètre `voice` de cette interface - Traitement asynchrone : utilisez l'ID de tâche retourné pour [interroger le résultat](/fr/api-manual/task-management/get-task-detail) - Le lien audio généré est valable 24 heures, veuillez le sauvegarder rapidement ## OpenAPI ````yaml fr/api-manual/audio-series/qwen-tts/qwen3-tts-vd.json POST /v1/audios/generations openapi: 3.1.0 info: title: Interface Qwen3 TTS VD - Synthèse Vocale description: >- Convertit du texte en audio vocal. Nécessite obligatoirement un timbre vocal personnalisé créé par qwen-voice-design ; les timbres système intégrés ne sont pas pris en charge. license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: Environnement de production security: - bearerAuth: [] tags: - name: Synthèse Vocale description: Interfaces relatives à la synthèse vocale Qwen3 TTS VD paths: /v1/audios/generations: post: tags: - Synthèse Vocale summary: Qwen3 TTS VD - Synthèse Vocale description: >- - Convertit du texte en audio vocal ; **doit obligatoirement utiliser un timbre personnalisé créé par [Qwen Voice Design](/fr/api-manual/audio-series/qwen-tts/qwen-voice-design)** ; les timbres système intégrés ne sont pas pris en charge - Flux d'utilisation : appelez d'abord `qwen-voice-design` pour créer un timbre → obtenez le nom `voice` → passez-le dans le paramètre `voice` de cette interface - Traitement asynchrone : utilisez l'ID de tâche retourné pour [interroger le résultat](/fr/api-manual/task-management/get-task-detail) - Le lien audio généré est valable 24 heures, veuillez le sauvegarder rapidement operationId: createQwen3TtsVd requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/Qwen3TtsVdRequest' examples: basic: summary: Appel de base value: model: qwen3-tts-vd prompt: Bonsoir à tous nos auditeurs, bienvenue au journal du soir. voice: qwen-tts-vd-announcer-voice-20260402-a1b2 with_language: summary: Spécifier la langue value: model: qwen3-tts-vd prompt: Bonsoir à tous nos auditeurs, bienvenue au journal du soir. voice: qwen-tts-vd-announcer-voice-20260402-a1b2 language_type: French responses: '200': description: Tâche de synthèse vocale créée avec succès content: application/json: schema: $ref: '#/components/schemas/Qwen3TtsVdResponse' '400': description: Paramètres de requête invalides content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: missing_text message: 'Missing required parameter: prompt or input' type: invalid_request_error '401': description: Non authentifié, token invalide ou expiré content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: Quota insuffisant, rechargement nécessaire content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: insufficient_quota message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: Accès refusé content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: 'Token does not have access to model: qwen3-tts-vd' type: invalid_request_error '429': description: Limite de fréquence de requêtes dépassée content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Too many requests, please try again later type: rate_limit_error '500': description: Erreur interne du serveur content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Internal server error type: api_error components: schemas: Qwen3TtsVdRequest: type: object required: - model - prompt - voice properties: model: type: string description: Nom du modèle enum: - qwen3-tts-vd default: qwen3-tts-vd example: qwen3-tts-vd prompt: type: string description: |- Texte à synthétiser **Contraintes :** - Maximum `600` caractères maxLength: 600 example: Bonsoir à tous nos auditeurs, bienvenue au journal du soir. voice: type: string description: >- Nom du timbre vocal - Vous devez d'abord créer un timbre via [Qwen Voice Design](/fr/api-manual/audio-series/qwen-tts/qwen-voice-design) - Récupérez-le depuis `result_data.voice` dans le résultat de la tâche Voice Design - Les timbres système intégrés ne sont pas pris en charge example: qwen-tts-vd-announcer-voice-20260402-a1b2 language_type: type: string description: >- Indication de langue pour aider le modèle à choisir les règles de prononciation Si non renseigné, détection automatique enum: - Auto - Chinese - English - Japanese - Korean - French - German - Spanish - Italian - Russian - Portuguese example: French callback_url: type: string description: >- URL de rappel HTTPS après la fin de la tâche **Déclenchement du rappel :** - Déclenché lorsque la tâche est terminée (completed), échouée (failed) ou annulée (cancelled) - Envoyé après confirmation de la facturation **Restrictions de sécurité :** - Uniquement le protocole HTTPS est pris en charge - Les rappels vers des adresses IP internes sont interdits (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.) - La longueur de l'URL ne doit pas dépasser `2048` caractères **Mécanisme de rappel :** - Délai d'expiration : `10` secondes - Maximum `3` nouvelles tentatives en cas d'échec (à `1` s / `2` s / `4` s après l'échec respectivement) - Le format du corps de rappel est identique à celui retourné par l'interface de requête de tâche - Un code de statut 2xx de l'URL de rappel est considéré comme un succès ; tout autre code déclenche une nouvelle tentative format: uri example: https://your-domain.com/webhooks/tts-completed Qwen3TtsVdResponse: type: object properties: created: type: integer description: Horodatage de création de la tâche example: 1775122733 id: type: string description: ID de la tâche example: task-unified-1775122733-lozyt2i5 model: type: string description: Nom du modèle réellement utilisé example: qwen3-tts-vd object: type: string enum: - audio.generation.task description: Type spécifique de la tâche progress: type: integer description: Pourcentage de progression de la tâche (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: Statut de la tâche enum: - pending - processing - completed - failed example: pending task_info: $ref: '#/components/schemas/AudioTaskInfo' description: Informations détaillées sur la tâche audio type: type: string enum: - audio description: Type de sortie de la tâche example: audio usage: $ref: '#/components/schemas/AudioUsage' description: Informations d'utilisation et de facturation ErrorResponse: type: object properties: error: type: object properties: code: type: string description: Identifiant du code d'erreur message: type: string description: Description de l'erreur type: type: string description: Type d'erreur AudioTaskInfo: type: object properties: can_cancel: type: boolean description: Indique si la tâche peut être annulée example: true estimated_time: type: integer description: Temps d'achèvement estimé (secondes) minimum: 0 example: 10 audio_type: type: string description: Type de tâche audio example: tts AudioUsage: type: object description: Informations d'utilisation properties: credits_reserved: type: number description: Nombre de crédits estimés consommés minimum: 0 example: 0.32 securitySchemes: bearerAuth: type: http scheme: bearer description: >- ##Toutes les interfaces nécessitent une authentification par Bearer Token## **Obtenir une clé API :** Visitez la [page de gestion des clés API](https://evolink.ai/dashboard/keys) pour obtenir votre clé API **Ajoutez ceci dans l'en-tête de la requête :** ``` Authorization: Bearer YOUR_API_KEY ``` ````