> ## 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 > - Konvertiert Text in Sprachaudio; **es muss eine benutzerdefinierte Stimme verwendet werden, die mit [Qwen Voice Design](/de/api-manual/audio-series/qwen-tts/qwen-voice-design) erstellt wurde** – systeminterne Stimmen werden nicht unterstützt - Arbeitsablauf: `qwen-voice-design` aufrufen, um eine Stimme zu erstellen → `voice`-Namen abrufen → an den `voice`-Parameter dieser API übergeben - Asynchroner Verarbeitungsmodus; verwenden Sie die zurückgegebene Aufgaben-ID, um das [Ergebnis abzufragen](/de/api-manual/task-management/get-task-detail) - Generierte Audiolinks sind 24 Stunden gültig – bitte rechtzeitig speichern ## OpenAPI ````yaml de/api-manual/audio-series/qwen-tts/qwen3-tts-vd.json POST /v1/audios/generations openapi: 3.1.0 info: title: Qwen3 TTS VD Sprachsynthese-API description: >- Konvertiert Text in Sprachaudio. Es ist eine benutzerdefinierte Stimme erforderlich, die mit qwen-voice-design erstellt wurde – systeminterne Stimmen werden nicht unterstützt. license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: Produktionsumgebung security: - bearerAuth: [] tags: - name: Sprachsynthese description: Qwen3 TTS VD Sprachsynthese-API-Endpunkte paths: /v1/audios/generations: post: tags: - Sprachsynthese summary: Qwen3 TTS VD Sprachsynthese description: >- - Konvertiert Text in Sprachaudio; **es muss eine benutzerdefinierte Stimme verwendet werden, die mit [Qwen Voice Design](/de/api-manual/audio-series/qwen-tts/qwen-voice-design) erstellt wurde** – systeminterne Stimmen werden nicht unterstützt - Arbeitsablauf: `qwen-voice-design` aufrufen, um eine Stimme zu erstellen → `voice`-Namen abrufen → an den `voice`-Parameter dieser API übergeben - Asynchroner Verarbeitungsmodus; verwenden Sie die zurückgegebene Aufgaben-ID, um das [Ergebnis abzufragen](/de/api-manual/task-management/get-task-detail) - Generierte Audiolinks sind 24 Stunden gültig – bitte rechtzeitig speichern operationId: createQwen3TtsVd requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/Qwen3TtsVdRequest' examples: basic: summary: Einfacher Aufruf value: model: qwen3-tts-vd prompt: >- Guten Abend, liebe Zuhörerinnen und Zuhörer. Willkommen zur Abendnachricht. voice: qwen-tts-vd-announcer-voice-20260402-a1b2 with_language: summary: Mit Sprachhinweis value: model: qwen3-tts-vd prompt: >- Guten Abend, liebe Zuhörerinnen und Zuhörer. Willkommen zur Abendnachricht. voice: qwen-tts-vd-announcer-voice-20260402-a1b2 language_type: German responses: '200': description: Sprachsynthese-Aufgabe erfolgreich erstellt content: application/json: schema: $ref: '#/components/schemas/Qwen3TtsVdResponse' '400': description: Ungültige Anfrageparameter 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: Nicht authentifiziert, ungültiges oder abgelaufenes Token content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: Unzureichendes Guthaben, Aufladung erforderlich 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: Zugriff verweigert 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: Anfragelimit überschritten 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: Interner Serverfehler 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: Modellname enum: - qwen3-tts-vd default: qwen3-tts-vd example: qwen3-tts-vd prompt: type: string description: |- Zu synthetisierender Text **Einschränkungen:** - Maximal `600` Zeichen maxLength: 600 example: >- Guten Abend, liebe Zuhörerinnen und Zuhörer. Willkommen zur Abendnachricht. voice: type: string description: >- Stimmname - Muss zuerst eine Stimme über [Qwen Voice Design](/de/api-manual/audio-series/qwen-tts/qwen-voice-design) erstellen - Den Wert aus `result_data.voice` im Voice Design-Aufgabenergebnis entnehmen - Systeminterne Stimmen werden nicht unterstützt example: qwen-tts-vd-announcer-voice-20260402-a1b2 language_type: type: string description: |- Sprachhinweis, der dem Modell hilft, Ausspracheregeln auszuwählen Wird automatisch erkannt, wenn nicht angegeben enum: - Auto - Chinese - English - Japanese - Korean - French - German - Spanish - Italian - Russian - Portuguese example: Auto callback_url: type: string description: >- HTTPS-Callback-URL, die nach Abschluss der Aufgabe aufgerufen wird **Auslösebedingungen:** - Wird ausgelöst, wenn die Aufgabe abgeschlossen, fehlgeschlagen oder abgebrochen wurde - Wird nach Abrechnungsbestätigung gesendet **Sicherheitsbeschränkungen:** - Nur HTTPS - Interne IP-Adressen werden blockiert (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x usw.) - URL-Länge darf `2048` Zeichen nicht überschreiten **Callback-Verhalten:** - Timeout: `10` Sekunden - Bis zu `3` Wiederholungsversuche nach Fehlern (nach 1s / 2s / 4s) - Antwortformat entspricht der Aufgaben-Abfrage-API - HTTP-2xx-Statuscode gilt als Erfolg; andere Codes lösen einen Wiederholungsversuch aus format: uri example: https://your-domain.com/webhooks/tts-completed Qwen3TtsVdResponse: type: object properties: created: type: integer description: Zeitstempel der Aufgabenerstellung example: 1775122733 id: type: string description: Aufgaben-ID example: task-unified-1775122733-lozyt2i5 model: type: string description: Tatsächlich verwendeter Modellname example: qwen3-tts-vd object: type: string enum: - audio.generation.task description: Spezifischer Aufgabentyp progress: type: integer description: Aufgabenfortschritt in Prozent (0–100) minimum: 0 maximum: 100 example: 0 status: type: string description: Aufgabenstatus enum: - pending - processing - completed - failed example: pending task_info: $ref: '#/components/schemas/AudioTaskInfo' description: Details zur Audioaufgabe type: type: string enum: - audio description: Ausgabetyp der Aufgabe example: audio usage: $ref: '#/components/schemas/AudioUsage' description: Nutzungs- und Abrechnungsinformationen ErrorResponse: type: object properties: error: type: object properties: code: type: string description: Fehlercodekennung message: type: string description: Fehlerbeschreibung type: type: string description: Fehlertyp AudioTaskInfo: type: object properties: can_cancel: type: boolean description: Gibt an, ob die Aufgabe abgebrochen werden kann example: true estimated_time: type: integer description: Geschätzte Abschlusszeit (Sekunden) minimum: 0 example: 10 audio_type: type: string description: Typ der Audioaufgabe example: tts AudioUsage: type: object description: Nutzungsinformationen properties: credits_reserved: type: number description: Geschätzte zu verbrauchende Credits minimum: 0 example: 0.32 securitySchemes: bearerAuth: type: http scheme: bearer description: >- ##Alle Endpunkte erfordern eine Bearer-Token-Authentifizierung## **API-Schlüssel abrufen:** Besuchen Sie die [API-Schlüsselverwaltungsseite](https://evolink.ai/dashboard/keys), um Ihren API-Schlüssel zu erhalten **Fügen Sie folgenden Header zu jeder Anfrage hinzu:** ``` Authorization: Bearer YOUR_API_KEY ``` ````