Skip to main content

​
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

FieldTypeRequiredDescription
cover_clip_idstringYesClip ID of the source track to cover.
promptstringNoNew lyrics. Supports Chinese and English. If omitted, uses the original.
tagsstringNoNew style tags (e.g. "流行 抒情" or "jazz piano"). If omitted, uses the original style.
titlestringNoNew track title.
mvstringNoModel version (e.g. "chirp-v3-5"). Uses default if omitted.
callback_urlstringNoWebhook URL for completion notification. See Webhooks.
retention_daysintegerNoDays 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": "流行 抒情 女声"
  }'