> ## Documentation Index
> Fetch the complete documentation index at: https://docs.musicmint.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cover / Remix

> Create a cover or remix of an existing clip with new lyrics and style

## Endpoint

```http theme={null}
POST /api/v1/music/cover
```

**Asynchronous.** Returns a `task_id`. Poll [Get Task](/api-reference/tasks/get) 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](/api-reference/webhooks).       |
| `retention_days` | integer | No       | Days to retain audio files. Default `7`.                                                |

## Response

```json theme={null}
{
  "code": 0,
  "message": "ok",
  "request_id": "req-1710000000000",
  "data": {
    "task_id": "64f3a1b2c8d9e0f1a2b3c4d5",
    "status": "queuing"
  }
}
```

## Example

```bash theme={null}
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": "流行 抒情 女声"
  }'
```