> For the complete documentation index, see [llms.txt](https://anyint.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://anyint.gitbook.io/docs/ai-music/use-cases.md).

# use cases

## Cover workflow with persona and stems

This is the most common production-style flow when you want a stable voice identity and post-production assets.

### Step 1: create a persona once

1. generate or locate a completed song whose voice you want to reuse
2. wait for the task to reach `SUCCESS`
3. call `/suno/generate-persona` with the completed `taskId` and `audioId`
4. store the returned `personaId`

### Step 2: upload a song for cover generation

```bash
curl -X POST "https://gateway.api.anyint.ai/suno/upload-cover" \
  -H "Authorization: Bearer $ANYINT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "uploadUrl": "https://your-storage.com/original-song.mp3",
    "customMode": true,
    "instrumental": false,
    "model": "V5",
    "style": "R&B, soul, warm vocals",
    "title": "Cover Version",
    "personaId": "your-persona-id",
    "callBackUrl": "https://your-domain.com/callback"
  }'
```

### Step 3: wait for completion and split stems

1. query `/suno/query/task?taskId=...` or wait for the callback
2. read the returned `audioId`
3. call `/suno/vocal-removal`
4. choose `separate_vocal` for two-track output or `split_stem` for multitrack output

## New-song creation workflow

This flow works well for consumer apps, demo builders, and content studios.

### Step 1: generate lyrics if needed

```bash
curl -X POST "https://gateway.api.anyint.ai/suno/generate-lyrics" \
  -H "Authorization: Bearer $ANYINT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A late-night R&B song about city life",
    "callBackUrl": "https://your-domain.com/callback"
  }'
```

### Step 2: create the song

1. choose a lyric variant
2. call `/suno/generate` in custom mode
3. store the returned `taskId`
4. wait for the task to reach `SUCCESS`

### Step 3: add post-processing

After the song is complete, you can optionally:

* call `/suno/generate-cover` for cover art
* call `/suno/timestamped-lyrics` for lyric alignment
* call `/suno/wav-generate` for lossless export
* call `/suno/mp4-generate` for music video output