Suno

Suno · ~1.5 min

$0.09per picture

Songs with vocals and music from a description or your own lyrics. Two tracks per run, MP3.

Suno V6 is the main Suno model: natural vocals, rich arrangements and expressive music. Describe a song and the lyrics are written for you, or turn on «Own lyrics and style» to set the words, title, genre, voice and length (up to 6 minutes). Each run gives two different tracks in MP3. Price per run.

ID: suno-v6 · $0.09 per run (2 MP3 tracks) · ~1.5 min

Parameters (field input). Settings other than prompt, custom_mode and instrumental apply when custom_mode=true.

Field	Type	Values	Description
`version`	string	v6, v6-wild, v6-mini, v5.5, v5, v4.5-plus, v4.5-all, v4.5, v4	Version: v6 (default), v6-wild, v6-mini, v5.5, v5, v4.5-plus, v4.5-all, v4.5, v4. Same price
`prompt`	string	up to 5000 chars	custom_mode=false: what the song is about (up to 3000 characters), lyrics are written for you. custom_mode=true: your lyrics (up to 5000), [Verse]/[Chorus] tags allowed
`custom_mode`	boolean	false	true — your own lyrics and the settings below (title required)
`instrumental`	boolean	false	true — no vocals
`title`	string	up to 80 chars	Title, up to 80 characters (custom_mode=true)
`style`	string	up to 1000 chars	Genre, instruments, mood, up to 1000 characters
`negative_tags`	string	up to 1000 chars	What to avoid in the sound
`vocal_gender`	string	auto, female, male	Voice: female, male or auto
`duration`	string	auto, 10…360	Target length, 10–360 s or auto
`variety`	string	auto, off, normal, high, extra, max	Variety of the results
`style_weight`	string	auto, 0, 0.05, 0.1, 0.15, 0.2, 0.25, 0.3, 0.35, 0.4, 0.45, 0.5, 0.55, 0.6, 0.65, 0.7, 0.75, 0.8, 0.85, 0.9, 0.95, 1	0–1: how strictly to follow the style
`weirdness_constraint`	string	auto, 0, 0.05, 0.1, 0.15, 0.2, 0.25, 0.3, 0.35, 0.4, 0.45, 0.5, 0.55, 0.6, 0.65, 0.7, 0.75, 0.8, 0.85, 0.9, 0.95, 1	0–1: boldness
`audio_weight`	string	auto, 0, 0.05, 0.1, 0.15, 0.2, 0.25, 0.3, 0.35, 0.4, 0.45, 0.5, 0.55, 0.6, 0.65, 0.7, 0.75, 0.8, 0.85, 0.9, 0.95, 1	0–1: sound weight (not for instrumental)

Example: a song from a description

curl -X POST https://mixmedia.tech/api/v1/jobs/createTask \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"suno-v6","input":{"prompt":"A cheerful birthday song for mum Olga, pop, female vocal"}}'

import os, requests

r = requests.post(
    "https://mixmedia.tech/api/v1/jobs/createTask",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    json={
      "model": "suno-v6",
      "input": {
        "prompt": "A cheerful birthday song for mum Olga, pop, female vocal"
      }
    },
)
print(r.json())  # {"code": 200, "data": {"taskId": "..."}}

const r = await fetch("https://mixmedia.tech/api/v1/jobs/createTask", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "model": "suno-v6",
    "input": {
      "prompt": "A cheerful birthday song for mum Olga, pop, female vocal"
    }
  }),
});
console.log(await r.json()); // { code: 200, data: { taskId: "..." } }

Example: your own lyrics

curl -X POST https://mixmedia.tech/api/v1/jobs/createTask \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"suno-v6","input":{"custom_mode":true,"title":"Summer evening","prompt":"[Verse]\nWarm wind, the sea is near\n[Chorus]\nSummer evening, you are here","style":"acoustic pop, guitar, warm","vocal_gender":"female","duration":"120"}}'

import os, requests

r = requests.post(
    "https://mixmedia.tech/api/v1/jobs/createTask",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    json={
      "model": "suno-v6",
      "input": {
        "custom_mode": True,
        "title": "Summer evening",
        "prompt": "[Verse]\nWarm wind, the sea is near\n[Chorus]\nSummer evening, you are here",
        "style": "acoustic pop, guitar, warm",
        "vocal_gender": "female",
        "duration": "120"
      }
    },
)
print(r.json())  # {"code": 200, "data": {"taskId": "..."}}

const r = await fetch("https://mixmedia.tech/api/v1/jobs/createTask", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "model": "suno-v6",
    "input": {
      "custom_mode": true,
      "title": "Summer evening",
      "prompt": "[Verse]\nWarm wind, the sea is near\n[Chorus]\nSummer evening, you are here",
      "style": "acoustic pop, guitar, warm",
      "vocal_gender": "female",
      "duration": "120"
    }
  }),
});
console.log(await r.json()); // { code: 200, data: { taskId: "..." } }

Price

$0.09 per run — the answer always has two different tracks. Parameters (length, style, lyrics) do not change the price. A failure is refunded in full.

Result

Same as any task: call recordInfo or receive a callback. Links to the two MP3 tracks are in resultJson.resultUrls (kept for 24 hours).

Error handling

API responses are JSON {"code", "msg", "data"}; errors also have a string error field (type). On /api/v1/* the HTTP status matches body code.

Example response bodies

400

{
  "code": 400,
  "msg": "input.duration: must be between 4 and 30, or \"auto\" / -1",
  "data": null,
  "error": "invalid_request_error"
}

401

{
  "code": 401,
  "msg": "Authentication failed. Please check your API key",
  "data": null,
  "error": "authentication_error"
}

402

{
  "code": 402,
  "msg": "Insufficient balance. Please top up and try again. Available: $0.01, required: $0.015. Top up at https://mixmedia.tech/cabinet/billing",
  "data": {
    "balance": "0.0100",
    "required": "0.0150",
    "currency": "USD",
    "topUpUrl": "https://mixmedia.tech/cabinet/billing"
  },
  "error": "payment_required"
}

429

{
  "code": 429,
  "msg": "Rate limit exceeded: 10 createTask/upload requests per 10 s per key. Retry after 8s",
  "data": null,
  "error": "rate_limit_error"
}

500

{
  "code": 500,
  "msg": "Internal server error",
  "data": null,
  "error": "server_error"
}

Codes on createTask / upload

code	error	Meaning	What to do
400	`invalid_request_error`	Invalid parameter or body	See `msg`
400	`unsupported_model`	Unknown model	Model list
401	`authentication_error`	Missing or invalid key	Check the key
402	`payment_required`	Not enough balance	Top up
403	`permission_error`	No access	Contact support
429	`rate_limit_error`	Too many requests	Wait for `Retry-After`
505	`model_disabled`	Model temporarily disabled	Pick another
500	`server_error`	Our failure	Retry later

Example msg values: Authentication failed. Please check your API key (401); Insufficient balance. Please top up and try again… (402).

Task errors (recordInfo)

If the task was created and then failed: state: "fail" (alias status: "failed"), failCode / failMsg, and error: { code, message, type }. Money is refunded (refunded: true).

failCode	error.type	Meaning
400	`nsfw_content_detected` / `invalid_request_error`	Moderation — `failMsg` is upstream text verbatim
422	`invalid_request_error`	The model rejected the parameters (e.g. a photo could not be downloaded)
501	`server_error`	The model could not generate (`failMsg`)
504	`timeout_error`	Timed out — retry
500 / 503	`server_error`	Service temporarily unavailable

Rate limits

What	Limit
createTask and upload	20 per 10 s per key
recordInfo / list / balance	100 per 10 s per key

Over the limit — HTTP 429 and Retry-After.

#Price

#Result

#Error handling

#Example response bodies

#Codes on createTask / upload

#Task errors (recordInfo)

#Rate limits