Suno

Suno · ~1.5 мин

$0.09за картинку

Песни с вокалом и музыка по описанию или по вашему тексту. Два варианта трека за запуск, MP3.

Suno V6 — главная модель Suno: естественный вокал, богатая аранжировка и выразительная музыка. Опишите песню — текст напишется сам, или включите «Свой текст и стиль» и задайте слова, название, жанр, голос и длительность (до 6 минут).

ID: suno-v6 · $0.09 за запуск (2 трека MP3) · ~1.5 мин

Параметры (поле input). Настройки кроме prompt, custom_mode и instrumental работают при custom_mode=true.

Поле	Тип	Значения	Описание
`version`	string	v6, v6-wild, v6-mini, v5.5, v5, v4.5-plus, v4.5-all, v4.5, v4	Версия: v6 (по умолчанию), v6-wild, v6-mini, v5.5, v5, v4.5-plus, v4.5-all, v4.5, v4. Цена одинакова
`prompt`	string	до 5000 симв.	custom_mode=false: о чём песня (до 3000 символов), текст напишется сам. custom_mode=true: ваш текст песни (до 5000), можно с тегами [Verse], [Chorus]
`custom_mode`	boolean	false	true — свой текст и настройки ниже (title обязателен)
`instrumental`	boolean	false	true — без вокала
`title`	string	до 80 симв.	Название, до 80 символов (custom_mode=true)
`style`	string	до 1000 симв.	Жанр, инструменты, настроение, до 1000 символов
`negative_tags`	string	до 1000 симв.	Чего избегать в звучании
`vocal_gender`	string	auto, female, male	Голос: female, male или auto
`duration`	string	auto, 10…360	Желаемая длина, 10–360 сек или auto
`variety`	string	auto, off, normal, high, extra, max	Разнообразие вариантов
`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: насколько строго следовать стилю
`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: смелость и необычность
`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: вес звучания (не для инструментала)

Пример: песня по описанию

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":"Весёлая песня на день рождения для мамы Оли, поп, женский вокал"}}'

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": "Весёлая песня на день рождения для мамы Оли, поп, женский вокал"
      }
    },
)
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": "Весёлая песня на день рождения для мамы Оли, поп, женский вокал"
    }
  }),
});
console.log(await r.json()); // { code: 200, data: { taskId: "..." } }

Пример: свой текст

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":"Летний вечер","prompt":"[Verse]\nТёплый ветер, море рядом\n[Chorus]\nЛетний вечер, ты со мной","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": "Летний вечер",
        "prompt": "[Verse]\nТёплый ветер, море рядом\n[Chorus]\nЛетний вечер, ты со мной",
        "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": "Летний вечер",
      "prompt": "[Verse]\nТёплый ветер, море рядом\n[Chorus]\nЛетний вечер, ты со мной",
      "style": "acoustic pop, guitar, warm",
      "vocal_gender": "female",
      "duration": "120"
    }
  }),
});
console.log(await r.json()); // { code: 200, data: { taskId: "..." } }

Цена

$0.09 за запуск — в ответе всегда два разных трека. Параметры (длина, стиль, текст) цену не меняют. Ошибка — полный возврат.

Результат

Как у любой задачи: запросите recordInfo или получите callback. Ссылки на два MP3 — в resultJson.resultUrls (хранятся 24 часа).

Обработка ошибок

Ответ API — JSON {"code", "msg", "data"}; при ошибке есть строковое поле error (тип). На /api/v1/* HTTP-статус совпадает с code в теле.

Примеры тел ответа

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"
}

Коды при createTask / upload

code	error	Что значит	Что делать
400	`invalid_request_error`	Неверный параметр или тело	Смотрите `msg`
400	`unsupported_model`	Нет такой модели	Список моделей
401	`authentication_error`	Нет ключа или он неверный	Проверьте ключ
402	`payment_required`	Не хватает денег	Пополните баланс
403	`permission_error`	Нет доступа	Напишите в поддержку
429	`rate_limit_error`	Слишком много запросов	Подождите `Retry-After`
505	`model_disabled`	Модель временно отключена	Выберите другую
500	`server_error`	Сбой у нас	Повторите позже

Примеры msg: Authentication failed. Please check your API key (401); Insufficient balance. Please top up and try again… (402).

Ошибки задачи (recordInfo)

Если задача уже создана и завершилась неудачей: state: "fail" (алиас status: "failed"), failCode / failMsg, объект error: { code, message, type }. Деньги возвращаются (refunded: true).

failCode	error.type	Что значит
400	`nsfw_content_detected` / `invalid_request_error`	Модерация — `failMsg` = текст upstream как есть
422	`invalid_request_error`	Модель не приняла параметры (например, не скачалось фото)
501	`server_error`	Модель не смогла сгенерировать (`failMsg`)
504	`timeout_error`	Слишком долго — повторите
500 / 503	`server_error`	Сервис временно недоступен

Лимиты запросов

Что	Лимит
createTask и upload	20 за 10 с на ключ
recordInfo / list / balance	100 за 10 с на ключ

Сверх лимита — HTTP 429 и Retry-After.

#Цена

#Результат

#Обработка ошибок

#Примеры тел ответа

#Коды при createTask / upload

#Ошибки задачи (recordInfo)

#Лимиты запросов