# 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.

- **Provider**: suno
- **Model ID**: suno/music-v5
- **Category**: music_generation
- **Credits**: 140 per request
- **Pricing Type**: fixed

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `prompt` (string, optional): Song description (customMode=false, max 500 chars) or exact lyrics (customMode=true, max 5000 chars). Optional only when customMode=true and instrumental=true.
- `weirdnessConstraint` (number, optional): Creativity/novelty constraint (Range: min: 0, max: 1)
- `audioWeight` (number, optional): Relative weight of audio vs other factors (Range: min: 0, max: 1)
- `styleWeight` (number, optional): Style adherence weight (Range: min: 0, max: 1)
- `negativeTags` (string, optional): Music styles to avoid, comma separated
- `style` (string, optional): Music style, e.g. Jazz, Classical, Electronic (required when customMode=true, max 1000 chars)
- `vocalGender` (string, optional): Preferred vocal gender (Options: `m`, `f`)
- `instrumental` (boolean, **required**): Generate instrumental music without vocals
- `title` (string, optional): Song title (required when customMode=true, max 100 chars)
- `customMode` (boolean, **required**): true: control style/title yourself (prompt becomes exact lyrics). false: simple mode — just describe the song in prompt.

## Example Request

```json
{
  "model": "suno/music-v5",
  "input": {
    "prompt": "A dreamy synthwave track about driving through a neon city at night",
    "customMode": false,
    "instrumental": false
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "replicate",
  "model": "black-forest-labs/flux-schnell",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Output Type

json

## Tags

suno, music, music-generation, text-to-music, audio

## Documentation

https://docs.sunoapi.org/suno-api/generate-music