Cover / Remix

Endpoint

POST /api/v1/music/cover

Asynchronous. Returns a task_id. Poll Get Task for results. Generates a new track inspired by an existing clip (cover_clip_id). You can override the lyrics (prompt), style (tags), or keep them from the original.

Request body

Field	Type	Required	Description
`cover_clip_id`	string	Yes	Clip ID of the source track to cover.
`prompt`	string	No	New lyrics. Supports Chinese and English. If omitted, uses the original.
`tags`	string	No	New style tags (e.g. `"流行抒情"` or `"jazz piano"`). If omitted, uses the original style.
`title`	string	No	New track title.
`mv`	string	No	Model version (e.g. `"chirp-v3-5"`). Uses default if omitted.
`callback_url`	string	No	Webhook URL for completion notification. See Webhooks.
`retention_days`	integer	No	Days to retain audio files. Default `7`.

Response

{
  "code": 0,
  "message": "ok",
  "request_id": "req-1710000000000",
  "data": {
    "task_id": "64f3a1b2c8d9e0f1a2b3c4d5",
    "status": "queuing"
  }
}

Example

curl -X POST https://api.example.com/api/v1/music/cover \
  -H "Authorization: Bearer sk-mm-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "cover_clip_id": "abc123def456",
    "prompt": "[主歌]\n月光照耀着大地\n[副歌]\n让我们一起飞翔",
    "tags": "流行 抒情 女声"
  }'

Getting Started

Overview

Music Generation

Lyrics

Audio Processing

AI Singer (Persona)

Tasks & Results

Endpoint

Request body

Response

Example

​Endpoint

​Request body

​Response

​Example

Endpoint

Request body

Response

Example