> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ttapi.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Отправка задачи генерации музыки

> Отправка задачи генерации музыки QW Music. Поддерживает режим генерации по тексту (prompt) и режим пользовательских текстов песен.

<Beta />

Отправка задачи генерации музыки QW Music. Поддерживает следующие режимы:

* **Генерация по тексту** (custom\_mode=false): Генерация музыки через естественное языковое описание
* **Пользовательские тексты песен** (custom\_mode=true): Указание style + lyrics для точного контроля
* **Кавер/Ремикс**: Передача референс-аудио `media`, доступно в любом из вышеуказанных режимов


## OpenAPI

````yaml openapi/ru/qwmusic.json POST /qwm/api/v1/services/aigc/audio-generation/audio-synthesis
openapi: 3.1.0
info:
  title: QW Music API
  description: >-
    QW Music API прозрачной передачи, полностью идентичный официальным телам
    запросов/ответов и путям DashScope. Шлюз выполняет только аутентификацию и
    биллинг, остальное передаётся как есть.
  version: 1.0.0
servers:
  - url: https://api.ttapi.io
security: []
paths:
  /qwm/api/v1/services/aigc/audio-generation/audio-synthesis:
    post:
      summary: Отправка задачи генерации музыки
      description: >-
        Отправка задачи генерации музыки QW Music. Поддерживает режим генерации
        по тексту (prompt) и режим пользовательских текстов песен.
      operationId: qwmAudioSynthesis
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AudioSynthesisRequest'
      responses:
        '200':
          description: 提交成功
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AudioSynthesisResponse'
components:
  schemas:
    AudioSynthesisRequest:
      type: object
      required:
        - model
      properties:
        model:
          type: string
          description: 'Название модели. Фиксированное значение: `pre-qwen-music-async-dev`.'
          default: pre-qwen-music-async-dev
          example: pre-qwen-music-async-dev
        input:
          type: object
          description: Входная информация. Обязательные поля зависят от custom_mode.
          properties:
            prompt:
              type: string
              description: >-
                Естественное языковое описание. Обязательно при
                custom_mode=false.
            lyrics:
              type: string
              description: >-
                Текст песни. Обязательно при custom_mode=true, поддерживает
                маркеры секций `[intro]`, `[chorus]`, `[inst]`.
            style:
              type: string
              description: Описание стиля. Обязательно при custom_mode=true.
            media:
              type: array
              description: >-
                Список референс-аудио. Передача media включает режим
                кавер/ремикс, независимо от custom_mode.
              items:
                type: object
                properties:
                  type:
                    type: string
                    description: 'Тип референс-аудио. Фиксированное значение: `melody`.'
                    enum:
                      - melody
                  url:
                    type: string
                    description: >-
                      URL референс-аудио. Длительность ≤10 мин, размер файла
                      ≤100MB.
        parameters:
          type: object
          description: Параметры генерации.
          properties:
            custom_mode:
              type: boolean
              description: >-
                Режим пользовательских текстов песен. false (по умолчанию) —
                режим prompt, требуется только prompt; true — режим
                пользовательских текстов, требуются style + lyrics.
              default: false
            return_candidate_audio:
              type: boolean
              description: Возвращать ли вторичное аудио.
            return_post_info:
              type: boolean
              description: Возвращать ли уточнённые style/lyrics.
            output_audio_settings:
              type: object
              description: Настройки выходного аудио.
              properties:
                format:
                  type: string
                  description: Формат выходного аудио.
                  enum:
                    - wav
                    - mp3
                    - flac
                  default: wav
                sample_rate:
                  type: integer
                  description: Частота дискретизации.
                  default: 48000
        hook_url:
          type: string
          description: >-
            URL обратного вызова (расширенное поле шлюза, отсутствует в
            официальном API). Шлюз вызовет этот URL по завершении задачи и
            удалит это поле перед пересылкой.
    AudioSynthesisResponse:
      type: object
      properties:
        request_id:
          type: string
          description: ID запроса.
        output:
          type: object
          properties:
            task_id:
              type: string
              description: ID задачи, используется для последующих запросов.
            task_status:
              type: string
              description: Статус задачи.
              enum:
                - PENDING
                - RUNNING
                - SUCCEEDED
                - FAILED

````