LogoAI Music API
Войти

Эндпоинт модели · POST /v2/extend

Extend Song API

Продолжайте завершённую генерацию за пределы её исходного конца. Наследуйте настройки исходного трека или направляйте продолжение своим промптом, стилем и названием — всё через один асинхронный REST-эндпоинт.

Оплата по цене модели исходного трека

Продлить песню, не переделывая её

Extend Song API продолжает уже сгенерированный трек. Укажите на завершённую генерацию через origin_task_id, выберите, какой из двух возвращённых вариантов аудио продолжать, с помощью extend_audio_index — и платформа сочинит новый фрагмент, который начинается там, где кончается исходник.

Два режима покрывают основные сценарии. Режим наследования (custom_mode: false) переиспользует исходные параметры — самый быстрый способ удлинить понравившийся дубль. Пользовательский режим (custom_mode: true) принимает новые prompt, style, title и extensionStartTime, чтобы перенаправить аранжировку — например, превратить энергичный припев в спокойный финал.

Быстрый старт: продлить и опросить

POST на /v2/extend с исходной задачей, затем опрашивайте /v2/feed?workId=... или задайте callback_url для вебхука.

curl
curl -X POST "https://udioapi.pro/api/v2/extend" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "origin_task_id": "gen20e094aeaadfe494ea33a5c80ee596083bksv",
    "extend_audio_index": 0,
    "custom_mode": true,
    "prompt": "Change the music style to be calm and lyrical.",
    "style": "lyrical"
  }'

curl -X GET "https://udioapi.pro/api/v2/feed?workId=YOUR_WORK_ID"

extensionStartTime необязателен; значения ограничиваются диапазоном 1 … (длительность источника − 1) секунд, по умолчанию — конец исходного трека.

Параметры запроса продления

Продления тарифицируются по цене модели исходного трека. Треки, созданные с chirp-v5 или chirp-v5-5, продлевает chirp-v6; треки старых моделей — chirp-v6-mini.

ПараметрТипОбязателенПримечания
origin_task_idstringобязателенtask_id вашего исходного запроса на генерацию
extend_audio_indexnumberобязателенКакое аудио продлевать: 0 или 1
custom_modebooleanопциональноfalse наследует параметры источника (по умолчанию); true включает пользовательские поля
promptstringпольз. режимНовый текст или описание, ≤ 5000 символов — обрезается
stylestringопциональноСтиль продолжения, ≤ 1000 символов — обрезается
titlestringопциональноНазвание продлённого трека, ≤ 80 символов — обрезается
extensionStartTimenumberопциональноТочка старта в секундах; ограничена 1 … (длительность − 1)
callback_urlstringопциональноПубличный HTTPS-вебхук для итогового результата

Отклонённое или неудачное продление возмещается автоматически — ответы 422 подсказывают, какой параметр исправить, а сбои после принятия видны как FAILED в feed с возвращёнными кредитами.

Что можно построить

Продления комбинируются с остальным аудио API.

Более длинные аранжировки

Сцепляйте продления для интро, куплетов и финалов длиннее оригинала.

Читать документацию

Перенаправить концовку

Пользовательский режим позволяет новым промптом и стилем вести продолжение.

Читать документацию

Сначала сгенерируйте источник

Создайте трек для продления через /v2/generate — семейство chirp-v6 работает на обоих эндпоинтах.

Читать документацию

Кавер на своё аудио

Хотите начать с загрузки? Эндпоинт upload-cover закрывает этот сценарий.

Читать документацию

Лирика с таймкодами

Получайте построчные тайминги текста для продлённого результата.

Читать документацию

Колбэки и опрос

Забирайте завершение через опрос /v2/feed или вебхук callback_url.

Читать документацию

Как это работает

От завершённой генерации до более длинного трека за четыре шага.

  1. 1

    Сгенерируйте исходный трек

    Создайте песню через /v2/generate и дождитесь SUCCESS. Сохраните task_id и выберите индекс аудио.

  2. 2

    Отправьте продление

    POST на /v2/extend с origin_task_id, extend_audio_index и опциональными пользовательскими полями.

  3. 3

    Опрос или callback

    Вызывайте GET /v2/feed?workId=... каждые 5–10 секунд или задайте callback_url для вебхука.

  4. 4

    Скачайте аудио

    При статусе SUCCESS feed содержит URL продлённого аудио — сохраните их в своём хранилище.

Платите по цене исходной модели

Продления тарифицируются за запрос по цене модели исходного трека — около $0.12 для трека на chirp-v6 и $0.10 для chirp-v6-mini при 1 USD = 100 кредитов.

Отклонённые (422) и неудачные продления возмещаются автоматически. Кредиты pay-as-you-go не сгорают.

Ограничения и примечания

  • Нужна завершённая исходная задача и выбор extend_audio_index 0 или 1 — большинство генераций возвращает два аудио.
  • Продления наследуют цену модели источника; треки chirp-v5/chirp-v5-5 продлевает chirp-v6, старые — chirp-v6-mini.
  • Слишком длинные значения prompt, style и title обрезаются, а не отклоняются.
  • extensionStartTime приводится к допустимому диапазону вместо отказа запроса.
  • URL аудио временные — скачивайте результаты в своё хранилище.

udioapi.pro — независимый сторонний сервис. Он не связан с Suno, Udio или MiniMax, не одобрен и не управляется ими.

FAQ по Extend Song API

Ответы о режимах, оплате и асинхронном процессе.

Что делает Extend Song API?

Продолжает завершённую генерацию за пределы её конца. Режим наследования переиспользует параметры источника; пользовательский режим принимает новые prompt, style, title и extensionStartTime.

Как тарифицируется продление?

По цене модели исходного трека за запрос. Продление трека на chirp-v6 стоит те же 12 кредитов, chirp-v6-mini — 10. Отклонённые и неудачные продления возмещаются автоматически.

Какое аудио продлевать?

extend_audio_index 0 — первый возвращённый вариант, 1 — второй; большинство генераций выдаёт два варианта.

Наследование или пользовательский режим?

Наследование (custom_mode: false) продолжает с исходными параметрами. Пользовательский режим (custom_mode: true) позволяет новым промптом, стилем и названием вести продолжение.

Что если extensionStartTime вне диапазона?

Значение приводится к 1 … (длительность источника − 1) секунд вместо отказа; отсутствующее или невалидное значение продлевает с конца исходного трека.

Стоят ли неудачные продления кредиты?

Нет. Запросы, отклонённые на валидации, возвращают 422, а задачи, упавшие после принятия, видны как FAILED в feed — кредиты возвращаются в обоих случаях.

Что почитать дальше