> 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/overview.md).

# overview

AI Music is a live AnyInt product surface published under `/suno/*`. It is designed for song generation and transformation workflows, not generic text or image inference.

## Base URL

`https://gateway.api.anyint.ai`

## Authentication

```http
Authorization: Bearer <ANYINT_API_KEY>
```

## Unified response format

```json
{
  "code": 200,
  "msg": "success",
  "data": {}
}
```

## Main capability groups

| Group           | What it includes                                                 |
| --------------- | ---------------------------------------------------------------- |
| Create          | new songs, lyric generation, continuation                        |
| Transform       | covers, upload-based continuation, add vocals, add accompaniment |
| Identity        | persona creation and reuse                                       |
| Post-process    | cover art, timestamped lyrics, stems, WAV export, MV export      |
| Task management | polling and webhooks                                             |

## Supported model labels

| Value      | Positioning              | Max duration |
| ---------- | ------------------------ | ------------ |
| `V4`       | base                     | 4 minutes    |
| `V4_5`     | faster generation        | 8 minutes    |
| `V4_5PLUS` | stronger vocal character | 8 minutes    |
| `V4_5ALL`  | stronger structure       | 8 minutes    |
| `V5`       | latest quality tier      | 8 minutes    |

## Typical lifecycle

1. submit a task such as `/suno/generate` or `/suno/upload-cover`
2. store the returned `taskId`
3. wait for a webhook or poll a `/suno/query/*` route
4. use the returned `audioId` for follow-up jobs such as persona creation, stems, WAV, or MV

## When to use AI Music vs Media APIs

Use AI Music when:

* the output is a song, cover, lyric package, or stem split
* you need persona reuse across tracks
* you want music-specific exports such as timestamped lyrics, WAV, or MV

Use [Media APIs](/docs/api-reference/media-apis.md) when:

* you need generic image generation
* you need generic image-and-audio-to-video workflows
* the job is not tied to a music task lifecycle