X-API-Key авторизация
Ключи формата ap_<nanoid(24)>. SHA-256 хеширование на сервере (полные ключи не хранятся). Возвращаются один раз при создании в ЛК.
API документация
API для AI-генерации песен
REST-эндпоинты для генерации лирики и AI-песен. Удобно для Telegram-ботов, контент-фабрик, генераторов поздравлений и интеграций со студиями. Авторизация X-API-Key, webhook callbacks, async + polling.
Публичная OpenAPI-спецификация выйдет к публичному запуску. Сейчас ниже — обзор планируемых endpoints. Для раннего доступа — напишите в support.
Архитектура
HMAC-SHA256 webhook
Опционально передаёте webhook_url в POST /songs/generate — после готовности песни получите callback с HMAC-подписью в заголовке X-Audiopanda-Signature.
Async + polling
Генерация песни в Mureka — это long-running job (1-3 мин). API сразу возвращает songId, статус опрашиваете через GET /songs/:id или принимаете webhook.
Rate limits и идемпотентность
Лимиты per-API-key (по тарифу). Поддержка Idempotency-Key для безопасных ретраев. Webhook повтор = no-op если событие уже доставлено.
Планируемые endpoints
Базовый URL: https://audio.cacatoo.ru/api/v1. Все запросы — JSON, авторизация через заголовокX-API-Key: ap_....
/api/v1/lyrics/generateСгенерировать лирикуПараллельный запуск DeepSeek V4 + Claude Opus 4.7. Возвращает 6 вариантов (3 + 3) с тегами структуры [verse]/[chorus]/[bridge]. Параметры: topic, styleHint (опц), language (ru | en).
/api/v1/lyrics/:id/refineДоработать вариант лирикиFollow-up инструкция к существующему варианту («сделай грустнее», «сократи припев»). Возвращает обновлённый вариант с сохранением структуры тегов.
/api/v1/songs/generateСоздать песнюЗапуск генерации в Mureka. Параметры: lyricsText, styleString, styleChips, durationSec (60 | 120 | 180), vocalGender (auto | male | female | mixed), webhookUrl (опц). Списывает 1 единицу «песен» из месячной квоты тарифа, либо 50 ₽ с баланса при перерасходе. Возвращает songId + status pending.
/api/v1/songs/:idПолучить статус песниPolling: status (pending | processing | done | failed). При done — resultUrl (MP3), resultCoverUrl, shareSlug, durationMs.
/api/v1/songsСписок песен пользователяПагинированный список с фильтрами (status, dateRange, query). Используется для интеграций с автоматическими каталогами.
/api/v1/songs/:id/shareВключить/выключить публичный шеринг{ shareEnabled: true | false }. При true — песня доступна по https://audio.cacatoo.ru/s/{slug}.
Ранний доступ к API
Если вы строите Telegram-бота для генерации поздравлений, контент-фабрику для рилсов, плагин для CRM свадебных агентств или другую интеграцию — напишите в support, дадим ранний доступ к API и поможем с интеграцией. Постом готовы выдать sandbox-ключ сразу после регистрации, бесплатные тестовые песни — по запросу.
Базовый URL ЛК: https://audio.cacatoo.ru/app. API-ключи генерируются в разделе «Настройки → API» после регистрации.
Первая песня — бесплатно
Опишите идею — получите готовую песню
Без регистрации, без карты, без подписки. DeepSeek и Claude Opus напишут лирику, Mureka сочинит музыку — обычно 1-3 минуты от идеи до MP3. При регистрации +50 ₽ на баланс — это ещё одна песня сразу после.