LogoAI Music API
Войти
APIЖурнал изменений (2/9)

Обновления для разработчиков

Журнал изменений API

Следите за выпущенными возможностями API, совместимостью и действиями, необходимыми для интеграции.

Последнее обновление

5 нояб. 2026 г.

История выпусков

Обновлений: 7
  1. Добавлено
    Обратная совместимостьPOST /v2/replace-sectionAll models

    Новое: замена фрагмента перегенерирует часть песни

    POST /v2/replace-section перегенерирует временное окно песни, созданной через /v2/generate или /v2/extend, и возвращает всю песню с обновлённым фрагментом.

    Что изменилось

    • Окно должно быть не короче 10 секунд, не длиннее 50% песни и 480 секунд и заканчиваться до конца песни. Недопустимые окна отклоняются до списания кредитов.
    • Примерно по 10 секунд с каждой стороны окна тоже перерисовываются, чтобы новая часть звучала естественно; остальная песня не меняется.
    • Если lyrics не передан, текст, звучащий внутри окна, подставляется автоматически.
    • Результаты, длительность которых отличается от оригинала более чем на 15 секунд, отбрасываются. Если результатов не осталось, задача получает FAILED и кредиты возвращаются.
    • 5 кредитов за запрос; отклонённые запросы и неудавшиеся задачи возвращаются автоматически.

    Влияние на интеграцию

    Изменять существующие интеграции не нужно. Чтобы начать, передайте origin_task_id, audio_id, infill_start_s, infill_end_s и prompt.

    Открыть документацию эндпоинта
  2. Изменено
    Обратная совместимостьPOST /v2/generate · /v2/extend · /v2/upload-cover/generateAll models

    Отклонённые запросы возвращают 422 или 500 с немедленным возвратом кредитов

    Эндпоинты создания теперь синхронно сообщают об отклонении валидации и возвращают кредиты, вместо ответа 200 с задачей, которая никогда не завершается.

    Что изменилось

    • 422 означает, что параметр запроса отклонён при валидации; сообщение указывает поле для исправления (например title или extensionStartTime).
    • 500 означает временный сбой; повторите позже.
    • Оба ответа содержат data.task_id, data.refunded и workId, а задача помечается FAILED.
    • Задачи, завершившиеся ошибкой после принятия, включая расширения, помечаются FAILED с fail_message, а кредиты возвращаются автоматически.
    • Ранее такие запросы возвращали 200, а задача оставалась IN_PROGRESS бесконечно.

    Влияние на интеграцию

    При 422 исправьте указанный параметр, при 500 повторите позже. Оба ответа содержат data.refunded.

    Открыть документацию эндпоинта
  3. Изменено
    Обратная совместимостьPOST /v2/extendAll models

    Запросы extend нормализуют текст и время старта вместо ошибки

    POST /v2/extend теперь обрезает слишком длинный текст Custom Mode и ограничивает extensionStartTime, поэтому отправка не отклоняется из-за этих полей.

    Что изменилось

    • title ограничен 80 символами; более длинные значения обрезаются.
    • prompt ограничен 5000 символами, style — 1000; более длинные значения обрезаются.
    • extensionStartTime ограничивается диапазоном 1 … (длительность источника - 1) секунд; отсутствующие или неверные значения используют конец исходного трека.
    • Расширения тарифицируются по цене модели исходного трека и создаются chirp-v6 (треки chirp-v5 / chirp-v5-5) или chirp-v6-mini (более старые треки).

    Влияние на интеграцию

    Обновление обратно совместимо. Держите title в пределах 80 символов, чтобы избежать обрезки.

    Открыть документацию эндпоинта
  4. Изменено
    Обратная совместимостьPOST /v2/generate · /v2/extend · /v2/upload-cover/generatechirp-v3-5 … chirp-v5-5

    Устаревшие идентификаторы chirp-v3-5 … chirp-v5-5 обслуживаются семейством chirp-v6

    Запросы с устаревшим идентификатором модели продолжают работать по прежней цене.

    Что изменилось

    • chirp-v5 и chirp-v5-5 (12 кредитов) обслуживаются chirp-v6.
    • chirp-v3-5, chirp-v4-0, chirp-v4-5, chirp-v4-5-plus и chirp-v4-5-all обслуживаются chirp-v6-mini.
    • Каждый устаревший идентификатор по-прежнему тарифицируется по прежней цене (5, 8, 10 или 12 кредитов).
    • model_name в status, feed и callback теперь всегда содержит публичное имя модели, создавшей аудио, например chirp-v6-mini.
    • Если поле model не указано, запрос тарифицируется по базовому уровню 5 кредитов и обслуживается chirp-v6-mini.

    Влияние на интеграцию

    Изменений не требуется. При удобной возможности обновите поле model на chirp-v6 или chirp-v6-mini.

    Открыть документацию эндпоинта
  5. Добавлено
    Обратная совместимостьPOST /v2/generate · /v2/upload-cover/generatechirp-v6 · chirp-v6-mini · chirp-v6-wild

    Модели chirp-v6, chirp-v6-mini и chirp-v6-wild

    Актуальная линейка моделей — семейство chirp-v6, доступное в generate, upload-cover и extend.

    Что изменилось

    • chirp-v6 — флагманская модель, chirp-v6-mini — быстрый экономичный уровень, chirp-v6-wild — более экспериментальный вариант.
    • chirp-v6 и chirp-v6-wild стоят 12 кредитов за запрос, chirp-v6-mini — 10.
    • Лимиты текста одинаковы для всех моделей: custom prompt 5000, inspiration prompt 3000, style 1000, title 80 (100 для upload-cover). Длинный ввод обрезается, а не отклоняется.
    • Расширения трека chirp-v6 используют ту же модель; поле duration передаётся для Custom Mode запросов generate.

    Влияние на интеграцию

    Обновление обратно совместимо. Для новых интеграций используйте chirp-v6-mini или chirp-v6.

    Открыть документацию эндпоинта
  6. Добавлено
    Обратная совместимостьPOST /v2/generate · /v2/upload-cover/generatechirp-v6 family

    Музыка по изображению через image_urls

    POST /v2/generate и POST /v2/upload-cover/generate теперь принимают референсные изображения, задающие настроение трека.

    Что изменилось

    • Передавайте image_urls как массив до 5 публично доступных URL изображений.
    • Поддерживаются JPEG, JPG, PNG и WEBP, до 10 МБ на изображение.
    • Изображения действуют только в режиме вдохновения (generate) и в non-custom режиме (upload-cover); в Custom Mode они игнорируются.
    • Ввод изображений добавляет 1 кредит к цене модели за запрос.
    • Текстовый промпт необязателен при наличии изображений; сочетайте оба для точного управления.

    Влияние на интеграцию

    Обновление обратно совместимо. Добавляйте image_urls только когда изображения должны влиять на результат.

    Открыть документацию эндпоинта
  7. Добавлено
    Обратная совместимостьPOST /v2/generatechirp-v5-5

    Настраиваемая длительность для chirp-v5-5

    Запросы пользовательского режима с chirp-v5-5 теперь могут задавать целевую длительность трека.

    Что изменилось

    • Поле duration доступно только для chirp-v5-5 в пользовательском режиме.
    • Передавайте число от 10 до 360 секунд.
    • При отсутствии или недопустимом значении используется 20 секунд.
    • Другие модели и режим вдохновения игнорируют это поле.

    Влияние на интеграцию

    Обновление обратно совместимо. Существующие запросы продолжат работать без изменений.

    Открыть документацию эндпоинта