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 -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.
| Parametre | Tür | Zorunlu | Notlar |
|---|---|---|---|
| origin_task_id | string | zorunlu | Orijinal üretim isteğinizin task_id'si |
| extend_audio_index | number | zorunlu | Hangi dönen ses uzatılacak: 0 veya 1 |
| custom_mode | boolean | isteğe bağlı | false kaynak parametrelerini devralır (varsayılan); true özel alanları etkinleştirir |
| prompt | string | özel mod | Yeni sözler veya açıklama, ≤ 5000 karakter — kırpılır |
| style | string | isteğe bağlı | Devamın stili, ≤ 1000 karakter — kırpılır |
| title | string | isteğe bağlı | Uzatılan parçanın başlığı, ≤ 80 karakter — kırpılır |
| extensionStartTime | number | isteğe bağlı | Saniye cinsinden başlangıç; 1 … (kaynak süresi − 1) ile sınırlı |
| callback_url | string | isteğ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.
Neler geliştirebilirsiniz
Uzatmalar ses API'sinin geri kalanıyla birleşir.
Daha uzun aranjmanlar
Orijinal süreyi aşan intro, verse ve outro'lar için uzatmaları zincirleyin.
Dokümanı okuSonu yeniden yönlendirin
Özel mod, yeni prompt ve stilin devamın yönünü belirlemesini sağlar.
Dokümanı okuÖnce kaynağı üretin
Uzatmak istediğiniz parçayı /v2/generate ile oluşturun — chirp-v6 ailesi iki uç noktada da çalışır.
Dokümanı okuKendi sesinizi cover'layın
Yüklemeyle başlamak mı? upload-cover uç noktası bu akışı karşılar.
Dokümanı okuZaman damgalı sözler
Uzatılmış sonucun satır düzeyinde söz zamanlamalarını alın.
Dokümanı okuCallback'ler ve polling
/v2/feed polling'i veya callback_url webhook'uyla tamamlanmayı alın.
Dokümanı okuNasıl çalışır
Tamamlanmış üretimden daha uzun parçaya dört adımda.
- 1
Kaynak parça üretin
/v2/generate ile şarkı oluşturup SUCCESS bekleyin. task_id'yi kaydedip ses dizini seçin.
- 2
Uzatmayı gönderin
origin_task_id, extend_audio_index ve isteğe bağlı özel alanlarla /v2/extend'e POST yapın.
- 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
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.