Model uç noktası · POST /v2/extend

Extend Song API

Tamamlanmış bir üretimi orijinal sonunun ötesine sürdürün. Kaynak parçanın ayarlarını devralın veya devamını kendi isteminiz, stiliniz ve başlığınızla yönlendirin — hepsi tek bir asenkron REST uç noktasıyla.

Orijinal parçanın model fiyatıyla ücretlendirilir

Şarkıyı yeniden yapmadan uzatın

Extend Song API, zaten ürettiğiniz bir parçayı sürdürür. origin_task_id ile tamamlanmış üretimi işaret edin, extend_audio_index ile döndürülen iki sesten hangisini sürdüreceğinizi seçin; platform, kaynağın bittiği yerden devam eden yeni bir bölüm besteler.

İki mod yaygın iş akışlarını kapsar. Devralma modu (custom_mode: false) orijinal parametreleri yeniden kullanır — beğendiğiniz bir çekimi uzatmanın en hızlı yolu. Özel mod (custom_mode: true) yeni prompt, style, title ve extensionStartTime kabul eder; böylece aranjmanı yeniden yönlendirebilirsiniz — örneğin enerjik bir nakaratı sakin bir outroya çevirmek.

Hızlı başlangıç: uzatın ve sorgulayın

Kaynak görevle /v2/extend'e POST yapın, ardından /v2/feed?workId=... sorgulayın veya webhook için callback_url ayarlayın.

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 isteğe bağlıdır; değerler 1 … (kaynak süresi − 1) saniyeye sınırlandırılır, varsayılan kaynak parçanın sonudur.

Uzatma isteği parametreleri

Uzatmalar orijinal parçanın model fiyatıyla ücretlendirilir. chirp-v5 veya chirp-v5-5 ile oluşturulan parçalar chirp-v6 ile, eski modellerin parçaları chirp-v6-mini ile uzatılır.

ParametreTürZorunluNotlar
origin_task_idstringzorunluOrijinal üretim isteğinizin task_id'si
extend_audio_indexnumberzorunluHangi dönen ses uzatılacak: 0 veya 1
custom_modebooleanisteğe bağlıfalse kaynak parametrelerini devralır (varsayılan); true özel alanları etkinleştirir
promptstringözel modYeni sözler veya açıklama, ≤ 5000 karakter — kırpılır
stylestringisteğe bağlıDevamın stili, ≤ 1000 karakter — kırpılır
titlestringisteğe bağlıUzatılan parçanın başlığı, ≤ 80 karakter — kırpılır
extensionStartTimenumberisteğe bağlıSaniye cinsinden başlangıç; 1 … (kaynak süresi − 1) ile sınırlı
callback_urlstringisteğe bağlıNihai sonuç için genel HTTPS webhook'u

Reddedilen veya başarısız uzatmalar otomatik iade edilir — 422 yanıtları düzeltilecek parametreyi gösterir, kabul sonrası hatalar feed'de FAILED olarak görünür ve krediler geri verilir.

Nasıl çalışır

Tamamlanmış üretimden daha uzun parçaya dört adımda.

  1. 1

    Kaynak parça üretin

    /v2/generate ile şarkı oluşturup SUCCESS bekleyin. task_id'yi kaydedip ses dizini seçin.

  2. 2

    Uzatmayı gönderin

    origin_task_id, extend_audio_index ve isteğe bağlı özel alanlarla /v2/extend'e POST yapın.

  3. 3

    Sorgulayın veya callback alın

    Her 5–10 saniyede GET /v2/feed?workId=... çağırın veya webhook için callback_url ayarlayın.

  4. 4

    Sesi indirin

    SUCCESS durumunda feed, uzatılmış ses URL'lerini içerir — kendi depolamanıza kaydedin.

Orijinal model fiyatını ödeyin

Uzatmalar orijinal parçanın model fiyatıyla istek başına ücretlendirilir — chirp-v6 ile sunulan parça için yaklaşık $0.12, chirp-v6-mini için $0.10 (1 USD = 100 kredi).

Reddedilen (422) ve başarısız uzatmalar otomatik iade edilir. Kullandıkça öde kredileri asla sona ermez.

Sınırlar ve notlar

  • Tamamlanmış bir kaynak görev gerekir ve extend_audio_index 0 veya 1 seçilmelidir — çoğu üretim iki ses döndürür.
  • Uzatmalar kaynak modelin fiyatını devralır; chirp-v5/chirp-v5-5 parçaları chirp-v6, eski parçalar chirp-v6-mini uzatır.
  • Aşırı uzun prompt, style ve title değerleri reddedilmez, kırpılır.
  • extensionStartTime isteği başarısız kılmak yerine geçerli aralığa çekilir.
  • Ses URL'leri geçicidir — sonuçları kendi depolamanıza indirin.

udioapi.pro bağımsız bir üçüncü taraf hizmetidir. Suno, Udio veya MiniMax ile bağlantılı değildir, bunlar tarafından desteklenmez veya işletilmez.

Extend Song API SSS

Modlar, faturalama ve asenkron akış hakkında yanıtlar.

Extend Song API ne yapar?

Tamamlanmış bir üretimi sonunun ötesine taşır. Devralma modu kaynak parametrelerini yeniden kullanır; özel mod yeni prompt, style, title ve extensionStartTime kabul eder.

Uzatma nasıl ücretlendirilir?

Orijinal parçanın model fiyatıyla istek başına. chirp-v6 ile sunulan parçayı uzatmak aynı 12 krediyi, chirp-v6-mini 10 krediyi gerektirir. Reddedilen ve başarısız uzatmalar otomatik iade edilir.

Hangi sesi uzatmalıyım?

extend_audio_index'i ilk ses için 0, ikinci ses için 1 yapın — çoğu üretim isteği iki varyasyon üretir.

Devralma mı özel mod mu?

Devralma modu (custom_mode: false) orijinal parametrelerle devam eder. Özel mod (custom_mode: true) yeni prompt, style ve title'ın devamı yönlendirmesini sağlar.

extensionStartTime aralık dışındaysa?

Değer başarısız olmak yerine 1 … (kaynak süresi − 1) saniyeye sınırlandırılır; eksik veya geçersiz değer kaynak parçanın sonundan uzatır.

Başarısız uzatmalar kredi harcar mı?

Hayır. Doğrulamada reddedilen istekler 422 döndürür, kabul sonrası başarısız görevler feed'de FAILED görünür — iki durumda da krediler iade edilir.