Skip to main content
POST
Submit Music Generation Task
Submit a QW Music generation task. Supports the following modes:
  • Text-to-music (custom_mode=false): Generate music via natural language prompt
  • Custom lyrics (custom_mode=true): Specify style + lyrics for precise control
  • Cover/Remix: Carry media reference audio, usable in either mode above

Body

application/json
model
string
default:pre-qwen-music-async-dev
required

Model name. Fixed value: pre-qwen-music-async-dev.

Example:

"pre-qwen-music-async-dev"

input
object

Input information. Required fields vary based on custom_mode.

parameters
object

Generation parameters.

hook_url
string

Callback URL (gateway extension field, not in official API). The gateway will call this URL upon task completion and strips this field before forwarding to the official API.

Response

200 - application/json

提交成功

request_id
string

Request ID.

output
object
Last modified on July 2, 2026