# Core.Today AI API — Music Generation Models (Suno)

> Suno music generation, sound effects and vocal separation models available through the Core.Today unified API.

Source: https://console.core.today/docs/music-generation
This file: https://console.core.today/llms/music-generation.txt
All models: https://console.core.today/llms.txt

## API Usage

Base URL: https://api.core.today/v1
Auth header: X-API-Key: YOUR_API_KEY

1. POST /predictions with {"model": "<model id>", "input": {...}} -> returns job_id
2. GET /predictions/{job_id} -> poll until status is "completed" or "failed"
3. result contains output URL(s); add "is_public": true for a permanent public URL

## Models (5)

### Suno Music V5.5 — `suno/music-v5-5`

Suno's latest model, with the highest audio quality and richest arrangements. Creates two complete songs from a text description, or from exact lyrics with style and title in custom mode. Returns audio, cover image, and metadata for each track.

- Provider: Suno
- Credits: 140 (per generation (2 songs))
- Speed: medium / Quality: ultra
- Required params: customMode (boolean), instrumental (boolean)
- Optional params: prompt, style, title, negativeTags, vocalGender, styleWeight, weirdnessConstraint, audioWeight
- Example input:
```json
{
  "model": "suno/music-v5-5",
  "input": {
    "customMode": false,
    "instrumental": false,
    "prompt": "A dreamy synthwave track about driving through a neon city at night"
  }
}
```
- Full docs: https://console.core.today/docs/models/suno/music-v5-5

### Suno Music V5 — `suno/music-v5`

Suno V5 music generation with improved audio quality and musicality. Creates two complete songs from a text description, or from exact lyrics with style and title in custom mode. Returns audio, cover image, and metadata for each track.

- Provider: Suno
- Credits: 140 (per generation (2 songs))
- Speed: medium / Quality: high
- Required params: customMode (boolean), instrumental (boolean)
- Optional params: prompt, style, title, negativeTags, vocalGender, styleWeight, weirdnessConstraint, audioWeight
- Example input:
```json
{
  "model": "suno/music-v5",
  "input": {
    "customMode": false,
    "instrumental": false,
    "prompt": "A dreamy synthwave track about driving through a neon city at night"
  }
}
```
- Full docs: https://console.core.today/docs/models/suno/music-v5

### Suno Music V4.5 — `suno/music-v4-5`

Suno V4.5 music generation. Creates two complete songs from a text description, or from exact lyrics with style and title in custom mode. Returns audio, cover image, and metadata for each track.

- Provider: Suno
- Credits: 140 (per generation (2 songs))
- Speed: medium / Quality: high
- Required params: customMode (boolean), instrumental (boolean)
- Optional params: prompt, style, title, negativeTags, vocalGender, styleWeight, weirdnessConstraint, audioWeight
- Example input:
```json
{
  "model": "suno/music-v4-5",
  "input": {
    "customMode": false,
    "instrumental": false,
    "prompt": "A dreamy synthwave track about driving through a neon city at night"
  }
}
```
- Full docs: https://console.core.today/docs/models/suno/music-v4-5

### Suno SFX V5 — `suno/sfx-v5`

Suno V5 sound effect generation. Creates two short sound effect variants from a text description, with optional loop mode, tempo, and musical key controls. Ideal for UI sounds, game audio, and video foley.

- Provider: Suno
- Credits: 29 (per generation (2 variants))
- Speed: fast / Quality: high
- Required params: prompt (string)
- Optional params: soundLoop, soundTempo, soundKey, grabLyrics
- Example input:
```json
{
  "model": "suno/sfx-v5",
  "input": {
    "prompt": "single soft door knock, dry room"
  }
}
```
- Full docs: https://console.core.today/docs/models/suno/sfx-v5

### Suno Vocal Separation — `suno/vocal-separation`

Separate a Suno-generated track into clean vocal and instrumental stems. Takes the taskId and audioId from a previous Suno music generation and returns separated vocalUrl/instrumentalUrl audio files.

- Provider: Suno
- Credits: 120 (per separation)
- Speed: fast / Quality: high
- Required params: taskId (string), audioId (string)
- Example input:
```json
{
  "model": "suno/vocal-separation",
  "input": {
    "taskId": "5c7998a1b2c3d4e5f60718293a4b5c6d",
    "audioId": "34fa3e86-2fc8-4f8a-8ea3-f58b664bde51"
  }
}
```
- Full docs: https://console.core.today/docs/models/suno/vocal-separation