> ## 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 API Documentation

> TTAPI QW Music API documentation, supporting text-to-music, custom lyrics, and reference audio cover/remix.

# QW Music API

<Beta />

This is the **QW Music API** overview page. QW Music is a passthrough interface for DashScope's official music generation model, with request/response bodies and paths fully consistent with the official API. The gateway only handles authentication and billing; everything else is passed through as-is.

## What QW Music API can do

* Generate music via [Submit music generation task](/api/en/qwmusic/generate) (supports text-to-music, custom lyrics, reference audio cover/remix)
* Query task status and get audio via [Query task result](/api/en/qwmusic/fetch)

## Common Endpoints

| Use Case         | Endpoint                                                 |
| :--------------- | :------------------------------------------------------- |
| Music generation | [Submit music generation task](/api/en/qwmusic/generate) |
| Result query     | [Query task result](/api/en/qwmusic/fetch)               |

## Recommended Workflow

1. Call [Submit music generation task](/api/en/qwmusic/generate) to submit a generation request.
2. Call [Query task result](/api/en/qwmusic/fetch) to check task status and get the audio URL.