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

Exclua uma voz projetada

OpenAPI

openapi: 3.1.0
info:
  title: CosyVoice Voice Design API — Delete a voice
  version: 1.0.0
servers:
  - url: https://maas.qwencloudapi.com/api/v1
    description: Singapore
security:
  - BearerAuth: []
paths:
  /services/audio/tts/customization:
    post:
      operationId: deleteVoiceDesignCosyVoice
      summary: Delete a designed voice
      description: Deletes a CosyVoice designed voice and releases its quota.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/DeleteRequest"
      responses:
        "200":
          description: Voice deleted successfully
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/DeleteResponse"
      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": "voice-enrollment",
              "input": {
                "action": "delete_voice",
                "voice_id": "cosyvoice-v3.5-plus-vd-announcer-xxxxxx"
              }
            }'
components:
  schemas:
    DeleteRequest:
      type: object
      required:
        - model
        - input
      properties:
        model:
          type: string
          description: Fixed to `voice-enrollment`.
          enum:
            - voice-enrollment
          example: voice-enrollment
        input:
          type: object
          required:
            - action
            - voice_id
          properties:
            action:
              type: string
              description: Fixed to `delete_voice`.
              enum:
                - delete_voice
              example: delete_voice
            voice_id:
              type: string
              description: The voice ID to delete.
              example: cosyvoice-v3.5-plus-vd-announcer-xxxxxx
    DeleteResponse:
      type: object
      properties:
        output:
          type: object
          description: Empty object for delete operations.
        usage:
          type: object
          properties:
            count:
              type: integer
              description: Fixed as `1`.
              example: 1
        request_id:
          type: string
          description: Request ID for troubleshooting.
          example: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: DashScope API key. Get one at [API key](/api-reference/preparation/api-key).