QwenCloudBRASIL
Tradução de apoio para consulta. Código e identificadores técnicos preservados. Consultar referência original ↗

Lista vozes clonadas

OpenAPI

openapi: 3.1.0
info:
  title: Qwen Voice Cloning API — List voices
  version: 1.0.0
servers:
  - url: https://maas.qwencloudapi.com/api/v1
    description: Singapore
security:
  - BearerAuth: []
paths:
  /services/audio/tts/customization:
    post:
      operationId: listVoicesCloningQwen
      summary: List cloned voices
      description: Returns a paginated list of Qwen cloned voices under your account.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/ListRequest"
      responses:
        "200":
          description: Voices listed successfully
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ListResponse"
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |-
            curl -X POST https://maas.qwencloudapi.com/api/v1/services/audio/tts/customization \
            -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
            -H "Content-Type: application/json" \
            -d '{
              "model": "qwen-voice-enrollment",
              "input": {
                "action": "list",
                "page_size": 10,
                "page_index": 0
              }
            }'
components:
  schemas:
    ListRequest:
      type: object
      required:
        - model
        - input
      properties:
        model:
          type: string
          description: Fixed to `qwen-voice-enrollment`.
          enum:
            - qwen-voice-enrollment
          example: qwen-voice-enrollment
        input:
          type: object
          required:
            - action
          properties:
            action:
              type: string
              description: Fixed to `list`.
              enum:
                - list
              example: list
            page_index:
              type: integer
              description: Page number (0-indexed).
              default: 0
              example: 0
            page_size:
              type: integer
              description: Results per page.
              default: 10
              example: 10
    ListResponse:
      type: object
      properties:
        output:
          type: object
          properties:
            page_index:
              type: integer
              description: Current page number.
              example: 0
            page_size:
              type: integer
              description: Entries per page.
              example: 10
            total_count:
              type: integer
              description: Total number of voices.
              example: 2
            voice_list:
              type: array
              description: Array of voice objects.
              items:
                $ref: "#/components/schemas/VoiceItem"
        usage:
          type: object
          properties:
            count:
              type: integer
              description: Fixed as `0`.
              example: 0
        request_id:
          type: string
          description: Request ID for troubleshooting.
          example: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
    VoiceItem:
      type: object
      properties:
        voice:
          type: string
          description: Voice name.
          example: qwen-tts-vc-guanyu-voice-20250812105009984-838b
        target_model:
          type: string
          description: Synthesis model bound to this voice.
          example: qwen3.5-omni-plus-realtime
        language:
          type: string
          description: Language code.
          example: zh
        gmt_create:
          type: string
          description: Creation timestamp.
          example: 2025-08-11 17:59:32
        gmt_modified:
          type: string
          description: Last modified timestamp.
          example: 2025-08-11 17:59:32
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: DashScope API key. Get one at [API key](/api-reference/preparation/api-key).