> ## 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 > - Convert text to speech audio; **must use a custom voice created with [Qwen Voice Design](/en/api-manual/audio-series/qwen-tts/qwen-voice-design)** — system built-in voices are not supported - Workflow: call `qwen-voice-design` to create a voice → obtain the `voice` name → pass it to the `voice` parameter of this API - Asynchronous processing mode; use the returned task ID to [query the result](/en/api-manual/task-management/get-task-detail) - Generated audio links are valid for 24 hours — save them promptly ## OpenAPI ````yaml /en/api-manual/audio-series/qwen-tts/qwen3-tts-vd.json POST /v1/audios/generations openapi: 3.1.0 info: title: Qwen3 TTS VD Speech Synthesis API description: >- Convert text to speech audio. A custom voice created with qwen-voice-design is required — system built-in voices are not supported. license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: Production environment security: - bearerAuth: [] tags: - name: Speech Synthesis description: Qwen3 TTS VD speech synthesis API endpoints paths: /v1/audios/generations: post: tags: - Speech Synthesis summary: Qwen3 TTS VD Speech Synthesis description: >- - Convert text to speech audio; **must use a custom voice created with [Qwen Voice Design](/en/api-manual/audio-series/qwen-tts/qwen-voice-design)** — system built-in voices are not supported - Workflow: call `qwen-voice-design` to create a voice → obtain the `voice` name → pass it to the `voice` parameter of this API - Asynchronous processing mode; use the returned task ID to [query the result](/en/api-manual/task-management/get-task-detail) - Generated audio links are valid for 24 hours — save them promptly operationId: createQwen3TtsVd requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/Qwen3TtsVdRequest' examples: basic: summary: Basic call value: model: qwen3-tts-vd prompt: >- Good evening, listeners. Welcome to the evening news broadcast. voice: qwen-tts-vd-announcer-voice-20260402-a1b2 with_language: summary: With language hint value: model: qwen3-tts-vd prompt: >- Good evening, listeners. Welcome to the evening news broadcast. voice: qwen-tts-vd-announcer-voice-20260402-a1b2 language_type: English responses: '200': description: Speech synthesis task created successfully content: application/json: schema: $ref: '#/components/schemas/Qwen3TtsVdResponse' '400': description: Invalid request parameters 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: Unauthenticated, invalid or expired token content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: Insufficient quota, top-up required 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: Access denied 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: Rate limit exceeded 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: Internal server error 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: Model name enum: - qwen3-tts-vd default: qwen3-tts-vd example: qwen3-tts-vd prompt: type: string description: |- Text to synthesize **Constraints:** - Maximum `600` characters maxLength: 600 example: Good evening, listeners. Welcome to the evening news broadcast. voice: type: string description: >- Voice name - Must first create a voice via [Qwen Voice Design](/en/api-manual/audio-series/qwen-tts/qwen-voice-design) - Obtain the value from `result_data.voice` in the Voice Design task result - System built-in voices are not supported example: qwen-tts-vd-announcer-voice-20260402-a1b2 language_type: type: string description: |- Language hint to help the model select pronunciation rules Auto-detected if not provided enum: - Auto - Chinese - English - Japanese - Korean - French - German - Spanish - Italian - Russian - Portuguese example: Auto callback_url: type: string description: >- HTTPS callback URL invoked when the task completes **Trigger conditions:** - Triggered when the task is completed, failed, or cancelled - Sent after billing confirmation **Security restrictions:** - HTTPS only - Internal IP addresses are blocked (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.) - URL length must not exceed `2048` characters **Callback behavior:** - Timeout: `10` seconds - Up to `3` retries after failure (at 1s / 2s / 4s intervals) - Response body format matches the task query API response - A 2xx status code is considered success; other codes trigger a retry format: uri example: https://your-domain.com/webhooks/tts-completed Qwen3TtsVdResponse: type: object properties: created: type: integer description: Task creation timestamp example: 1775122733 id: type: string description: Task ID example: task-unified-1775122733-lozyt2i5 model: type: string description: Actual model name used example: qwen3-tts-vd object: type: string enum: - audio.generation.task description: Specific task type progress: type: integer description: Task progress percentage (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: Task status enum: - pending - processing - completed - failed example: pending task_info: $ref: '#/components/schemas/AudioTaskInfo' description: Audio task details type: type: string enum: - audio description: Task output type example: audio usage: $ref: '#/components/schemas/AudioUsage' description: Usage and billing information ErrorResponse: type: object properties: error: type: object properties: code: type: string description: Error code identifier message: type: string description: Error description type: type: string description: Error type AudioTaskInfo: type: object properties: can_cancel: type: boolean description: Whether the task can be cancelled example: true estimated_time: type: integer description: Estimated completion time (seconds) minimum: 0 example: 10 audio_type: type: string description: Audio task type example: tts AudioUsage: type: object description: Usage information properties: credits_reserved: type: number description: Estimated credits to be consumed minimum: 0 example: 0.32 securitySchemes: bearerAuth: type: http scheme: bearer description: >- ##All endpoints require Bearer Token authentication## **Get your API Key:** Visit the [API Key management page](https://evolink.ai/dashboard/keys) to obtain your API Key **Add the following header to every request:** ``` Authorization: Bearer YOUR_API_KEY ``` ````