Suno
Sign in to try Suno
Sign in with your Google account and top up credits to get started.
Sign in with GoogleUse via API
Base URL: https://adverraai.com/hub/api/v1 · Authenticate with Authorization: Bearer YOUR_API_KEY — create a key in your dashboard
# 1) Submit a task
curl https://adverraai.com/hub/api/v1/music/generations \
-H "Authorization: Bearer $ADVERRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno",
"prompt": "a cinematic shot of a city at night"
}'
# => {"id":"task_xxx","status":"queued",...}
# 2) Check status (every 3-5 seconds until status = completed)
curl https://adverraai.com/hub/api/v1/tasks/task_xxx -H "Authorization: Bearer $ADVERRA_API_KEY"
# => {"status":"completed","output":[{"type":"audio","url":"https://..."}]}
import requests, time
API = "https://adverraai.com/hub/api/v1"
H = {"Authorization": "Bearer YOUR_API_KEY"}
task = requests.post(f"{API}/music/generations", headers=H, json={
"model": "suno",
"prompt": "a cinematic shot of a city at night"
}).json()
while task["status"] not in ("completed", "failed"):
time.sleep(4)
task = requests.get(f"{API}/tasks/{task['id']}", headers=H).json()
print(task["status"], [o["url"] for o in task["output"]], task["credits_charged"])
const API = "https://adverraai.com/hub/api/v1", H = { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" };
let task = await (await fetch(`${API}/music/generations`, { method: "POST", headers: H, body: JSON.stringify({
model: "suno",
"prompt": "a cinematic shot of a city at night"
}) })).json();
while (!["completed", "failed"].includes(task.status)) {
await new Promise(r => setTimeout(r, 4000));
task = await (await fetch(`${API}/tasks/${task.id}`, { headers: H })).json();
}
console.log(task.output);
Common parameters: prompt, image_urls, size / aspect_ratio, resolution, duration, n, negative_prompt, seed. Credits are reserved at an estimated price when you submit and adjusted to the actual cost when the task finishes (failed tasks are fully refunded).
Parameters for this model
Send as JSON in the request body. Fields marked * are required.
| Parameter | Type | Allowed values | Default | Description |
|---|---|---|---|---|
model * |
string | – | – | ID of the model to call — suno |
custom |
boolean | true, false | false | Custom mode with your own lyrics, style and title |
instrumental |
boolean | true, false | false | Instrumental only, without vocals |
version |
string | v6, v6-wild, v6-mini | v6 | Model version to use |
prompt |
string | – | – | Text describing what to generate |
title |
string | – | – | Title of the piece |
style |
string | – | – | Style of the result |
negative_tags |
string | – | – | Negative style tags (styles you don't want). **Only takes effect when custom=true**. |
auto_lyrics |
boolean | true, false | false | true=rewrite the provided lyrics creatively. **Only takes effect when custom=true**. |
persona_id |
string | – | – | Persona Style ID. Only applies when custom=true is used and mutually exclusive with custom_model_id. |
vocal_gender |
string | Male, Female | – | Gender of the vocals |
style_weight |
number | 0 – 1 | – | Style weight, 0.00–1.00. Validated and effective in both modes. |
weirdness_constraint |
number | 0 – 1 | – | creative score, 0.00–1.00. Both modes will validate and take effect. |
audio_weight |
number | 0 – 1 | – | Audio weight, 0.00–1.00. Validated and effective in both modes. |
variety |
string | off, normal, high, extra, max | – | Style variation: off / normal / high / extra / max. Optional; there is no fixed default. |
max_mode |
boolean | true, false | false | Whether to enable Max mode. Enable it requires custom=true and charges at twice the normal price. |
audio_format |
string | mp3, m4a, wav | – | Output audio format: mp3 / m4a / wav. If omitted, the service chooses the default. |
duration |
number | 10 – 360 | – | Length of the result in seconds |
About this model
Suno is a Music & Audio model by Suno
Suno is an AI model and creative tool designed for music generation. Users can create complete songs from text prompts, including vocals, melodies, arrangements, and lyrics. It is useful for quickly producing demos, musical ideas, short-form video soundtracks, advertising music, and song prototypes
Preparing details in English…
Examples
Sample videos from the model developer's official channels