> ## 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 文档

> 查看 TTAPI 提供的 QW Music API 文档，支持文生曲、自定义歌词、参考音频翻唱等能力。

# QW Music API

<Beta />

这里是 TTAPI 的 **QW Music API** 总览页。QW Music 是 DashScope 官方音乐生成模型的透传接口，请求体 / 返回体 / 路径与官方完全一致，网关只做鉴权和计费，其余原样透传。

## QW Music API 可以做什么

* 通过 [提交音乐生成任务](/api/cn/qwmusic/generate) 生成音乐（支持文生曲、自定义歌词、参考音频翻唱/改编）
* 通过 [查询任务结果](/api/cn/qwmusic/fetch) 查询任务状态和获取音频

## 常用接口

| 使用场景 | 接口                                   |
| :--- | :----------------------------------- |
| 音乐生成 | [提交音乐生成任务](/api/cn/qwmusic/generate) |
| 结果查询 | [查询任务结果](/api/cn/qwmusic/fetch)      |

## 推荐接入流程

1. 调用 [提交音乐生成任务](/api/cn/qwmusic/generate) 提交生成请求。
2. 调用 [查询任务结果](/api/cn/qwmusic/fetch) 查询任务状态，获取音频 URL。