Перейти к основному содержанию

Documentation Index

Fetch the complete documentation index at: https://speshu.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Генерация музыки от Suno — вокальные и инструментальные треки из текстового описания. Поддерживает версии V3.5–V5, custom mode с текстом песни и настройкой стиля. Стоимость: 15 ₽ за генерацию.
Полная документация API: Генерация медиа

​
Обзор

ХарактеристикаЗначение
ID моделиsuno/generate
Эндпоинт/api/v1/media
Max prompt5 000 символов
Max style1 000 символов
Max title80 символов
ВерсииV5 (по умолчанию), V4_5ALL, V4_5PLUS, V4_5, V4, V3_5
Стоимость15 ₽ за запрос

​
Возможности

  • Text-to-Music: Создание музыки по текстовому описанию
  • Custom Mode: Написание текста песни, выбор стиля и названия трека
  • Инструментал: Генерация музыки без вокала
  • Выбор версии: 6 версий модели от V3.5 до V5

​
Параметры

ПараметрОбязательныйОписание
modelДаsuno/generate
promptДаОписание трека или текст песни (до 5 000 символов). В custom mode используется как lyrics — поддерживает теги [Verse], [Chorus], [Bridge] и др.
styleНетЖанр/стиль музыки (до 1 000 символов). Обязателен при использовании custom mode. Пример: Pop, Electronic, Upbeat
titleНетНазвание трека (до 80 символов). Обязателен при использовании custom mode
versionНетВерсия модели: V5 (по умолчанию), V4_5ALL, V4_5PLUS, V4_5, V4, V3_5

​
Пример запроса (cURL)

curl -X POST "https://speshu.ai/api/v1/media" \
  -H "Authorization: Bearer <SPESHU_AI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno/generate",
    "input": {
      "prompt": "Энергичный электронный трек для тренировки с драйвовым битом"
    }
  }'

​
Custom Mode (текст песни + стиль)

curl -X POST "https://speshu.ai/api/v1/media" \
  -H "Authorization: Bearer <SPESHU_AI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno/generate",
    "input": {
      "prompt": "[Verse]\nГород спит, а мы не спим\nОгни мерцают в тишине\n\n[Chorus]\nМы летим, мы летим\nНад ночным городом во сне",
      "style": "Pop, Synth-pop, Dream pop",
      "title": "Ночной город"
    }
  }'

​
Советы

Простой режим vs Custom Mode В простом режиме достаточно передать prompt с описанием желаемой музыки — Suno сам сгенерирует текст и подберёт стиль. В custom mode вы контролируете текст песни (prompt), стиль (style) и название (title). Как писать промпты Описывайте настроение, жанр и инструменты: «Меланхоличная акустическая баллада с гитарой и скрипкой». Для custom mode используйте структурные теги: [Verse], [Chorus], [Bridge], [Outro]. Выбор версии модели V5 — последняя и наиболее качественная версия, используется по умолчанию. Более ранние версии (V4, V3.5) могут давать другой звук — экспериментируйте при необходимости.

​
Асинхронная генерация

Генерация музыки — асинхронный процесс. После отправки запроса вы получите id, который нужно использовать для проверки статуса:
  1. Отправка запроса: POST запрос на /api/v1/media возвращает id генерации
  2. Проверка статуса: GET запрос на /api/v1/media/{id} возвращает текущий статус
  3. Получение результата: Когда статус completed, в ответе будут URL аудиофайла, обложка, название и длительность трека