Suno V6
Suno V6 music generation: full songs with vocals or instrumentals from a description, or your own lyrics and style in custom mode. Each request returns two tracks.
Model ID: suno-v6
Playground
10 – 360
Use the same request from code — API docs
Provider prices for this request
Enter a prompt to compare provider prices.
Result
Your generation will appear here.
Pricing by provider
Prices are per unit; requests without a provider are routed to the cheapest provider that supports your parameters.
| Provider | Option | Price (USD) | Credits |
|---|---|---|---|
| EvoLink | All options | 27 / request |
API reference
Endpoints
Base URL: https://01router.com/api/v1
/generationsCreate a generation (charges credits)/generations/{id}Get a generation; polls the provider while running/quotePrice a request on every provider (no charge, no key needed)Authentication
Send your API key as a Bearer token. Requests are billed to the key owner's credits.
Authorization: Bearer sk_xxxxxxxxxxxxxxxxRequest body
| Name | Type | Required | Description |
|---|---|---|---|
| model | string | Yes | "suno-v6" |
| provider | string | No | Pin a provider; omit to auto-route to the cheapest. One of: evolink |
| input | object | Yes | Model parameters, see the input fields below. |
input fields
Unified parameters work on every provider; some providers support a narrower range — check the quote endpoint or the playground.
| Name | Type | Values | Default |
|---|---|---|---|
| prompt Song description (simple mode) or lyrics (custom mode) | text | — | — |
| custom_mode Use your own lyrics, style and title | boolean | — | false |
| instrumental | boolean | — | false |
| style Custom mode only, e.g. "dream pop, female vocals" | string | — | — |
| title Custom mode only | string | — | — |
| negative_tags | string | — | — |
| vocal_gender | enum | m | f | — |
| duration Custom mode only | integer | 10 – 360 | — |
Example request
curl https://01router.com/api/v1/generations \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"provider": "evolink",
"input": {
"prompt": "An upbeat synth-pop song about a road trip at sunset",
"custom_mode": false,
"instrumental": false
}
}'
# poll until status is "succeeded" or "failed"
curl https://01router.com/api/v1/generations/<id> -H "Authorization: Bearer $API_KEY"Response
Pass the model id, its unified input parameters and optionally a provider slug. The response returns immediately with the task id; image models on synchronous providers may already be succeeded.
{
"id": "gen_6f1c…",
"object": "generation",
"model": "suno-v6",
"type": "audio",
"provider": "evolink",
"status": "processing",
"input": {
"prompt": "…",
"custom_mode": false,
"instrumental": false
},
"outputs": [],
"error": null,
"credits": 0,
"price_usd": 0,
"created_at": "2026-10-23T08:00:00.000Z",
"completed_at": null
}Get the result
Poll every few seconds until status is succeeded or failed. Output URLs are provider-hosted and may expire — download them promptly.
curl https://01router.com/api/v1/generations/gen_6f1c… -H "Authorization: Bearer $API_KEY"
{ "id": "gen_6f1c…", "model": "suno-v6", "status": "succeeded", "outputs": ["https://…"], … }Quote
Same body as creating a generation. Returns every available provider sorted by price, plus the ones that cannot serve the request and why.
curl https://01router.com/api/v1/quote -H "Content-Type: application/json" \
-d '{"model":"suno-v6","input":{"prompt":"…","custom_mode":false,"instrumental":false}}'Auth, routing, billing and error codes are covered in Gateway API reference