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.
Test this model instantly in the Console Playground โ no code required
Copy usage instructions for Claude, ChatGPT, or other AI
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "suno/music-v5-5",
"input": {
"customMode": false,
"instrumental": false,
"prompt": "A dreamy synthwave track about driving through a neon city at night"
}
}'| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
customMode | boolean | Yes | - | true: control style/title yourself (prompt becomes exact lyrics). false: simple mode |
instrumental | boolean | Yes | - | Generate instrumental music without vocals |
prompt | string | No | - | Song description (simple mode, max 500 chars) or exact lyrics (custom mode, max 5000 chars) |
style | string | No | - | Music style, required in custom mode (max 1000 chars) |
title | string | No | - | Song title, required in custom mode (max 100 chars) |
negativeTags | string | No | - | Music styles to avoid, comma separated (custom mode) |
vocalGender | string | No | - | Preferred vocal gender: m or f mf |
styleWeight | number | No | - | Style adherence weight, 0-1 (custom mode) |
weirdnessConstraint | number | No | - | Creativity/novelty constraint, 0-1 (custom mode) |
audioWeight | number | No | - | Relative weight of the audio factors, 0-1 (custom mode) |
Common parameters used when calling POST /v1/predictions.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
model | string | Yes | - | Model identifier |
input | object | Yes | - | Object containing the model-specific parameters from the table above |
output_folder | string | No | - | Folder path for output files (max 256 chars, '..' not allowed) |
webhook_url | string | No | - | Webhook URL to call on completion |
is_public | boolean | No | false | If true, output files are also available via permanent public URLs |
Generate two full songs from a short mood/genre/topic description
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "suno/music-v5-5",
"input": {
"customMode": false,
"instrumental": false,
"prompt": "A dreamy synthwave track about driving through a neon city at night"
}
}'POST /v1/predictions