song-skill

Небольшой shareable skeleton Hermes skill для генерации песен через Suno-compatible API. Скилл принимает /song запрос, передаёт lyrics/style/title во внешний API и ждёт готовые аудиоссылки через polling.

Структура

song-skill/
├── .env.example
├── README.md
├── .gitignore
├── SKILL.md
└── scripts/
    └── suno-generate.mjs

Установка

1. Скопируй папку в нужное место.
2. Создай .env на основе .env.example.
3. Заполни значения провайдера.
4. Убедись, что используешь Node.js 18+ (нужен встроенный fetch).

Настройка

Пример:

cp .env.example .env

Основные переменные в .env.example:

• SUNO_API_BASE_URL — базовый URL провайдера
• SUNO_API_KEY — API key
• SUNO_GENERATE_ENDPOINT — endpoint запуска генерации
• SUNO_STATUS_ENDPOINT — endpoint проверки статуса ({id} заменяется на job/task id)
• SUNO_MODEL — модель провайдера
• SUNO_POLL_SEC / SUNO_TIMEOUT_SEC — polling и таймаут

Запуск

Скрипт можно вызвать напрямую:

node scripts/suno-generate.mjs \
  --request-file /tmp/song-request.json \
  --result-file /tmp/song-result.json

Ожидаемый request JSON:

{
  "title": "My Song",
  "stylePrompt": "gentle duet, flute, ambient",
  "lyrics": "...",
  "instrumental": false
}

Результат записывается в result-file как JSON с ok, audioUrls, jobId, status и raw.

Безопасность

• Не коммить .env и любые реальные ключи.
• Храни секреты только локально или в secret manager.
• Перед публикацией проверь репозиторий поиском по известным ключам и токенам.
• .env.example должен содержать только плейсхолдеры, без реальных значений.