API Extend (ادامه‌دادن)

به‌روزرسانی 2026-09-18 · تیم Suno-API

توضیح نقطه پایانی

Extend یک آهنگ موجود را از یک نقطه زمانی انتخابی ادامه می‌دهد و بخش بعدی را تولید می‌کند.

نقطه پایانی: POST /api/music/extend

صورت‌حساب: پرداختی، فعلاً به‌طور پیش‌فرض 0.6 یوان برای هر فراخوانی. مبلغی که واقعاً کسر می‌شود تابع پیکربندی فعلی قیمت در پنل مدیریت است.

Max Mode / Variety: این نقطه پایانی دو پارامتر اختیاری max_mode و variety (0-4) را پشتیبانی می‌کند. با روشن‌بودن max_mode این فراخوانی با 2 برابر قیمت حساب می‌شود (0.6 → 1.2 یوان برای هر فراخوانی)؛ variety هزینه اضافی ندارد. معنی و روش ارسال آن‌ها در بخش «پارامترهای پیشرفته» در مرور کلی API جدید آمده است.

زمان‌های انتظار و مهلت‌ها (مهم): این نقطه پایانی همزمان است — سفارش تنها زمانی پذیرفته و به تولید سپرده می‌شود که پاسخ برسد. بر پایه اندازه‌گیری، بیشتر درخواست‌ها در 1-3 ثانیه پاسخ می‌دهند، حدود 10% بیش از 30 ثانیه طول می‌کشند و طولانی‌ترین حدود 230 ثانیه است. مهلت سمت کلاینت را 300 ثانیه یا بیشتر بگذارید؛ نبود پاسخ به معنای تولید نشدن نیست، و بلافاصله پس از مهلت دوباره تلاش نکنید (سفارش را تکرار می‌کند و دوباره هزینه می‌گیرد). اگر اتصال قطع شد، بعداً با GET /api/music/songs بررسی کنید. بخش «زمان‌های انتظار و تنظیم مهلت» در مرور کلی API جدید را ببینید.

پارامترهای درخواست

Headers

پارامترهای بدنه

نمونه درخواست

curl -X POST https://www.suno-api.io/api/music/extend \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "audioId": "clip_id",
    "prompt": "کورس را با احساس قوی‌تر ادامه بده",
    "continueAt": 60,
    "style": "Mandopop, rock",
    "negativeTags": "noise",
    "title": "نسخه ادامه‌یافته",
    "waitAudio": false
  }'

پاسخ

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "extended_clip_id",
        "song_title": "نسخه ادامه‌یافته",
        "status": "pending"
      }
    ]
  }
}

فیلدهای سازگار

نام‌های قدیمی فیلدها هنوز پذیرفته می‌شوند:

نکات

• نقطه شروع را چسبیده به پایان نگذارید: طول بخش ادامه‌یافته عملاً برابر «آنچه پس از نقطه شروع باقی مانده» است. اگر نقطه شروع بیش از حد به پایان نزدیک باشد، نتیجه فقط چند ثانیه خواهد بود — بر پایه اندازه‌گیری، آهنگی 242 ثانیه‌ای که از ثانیه 240 ادامه داده شد تنها 2.7 ثانیه تولید کرد (و همچنان هزینه هر فراخوانی دریافت می‌شود). دست‌کم 10 ثانیه پس از نقطه شروع باقی بگذارید.
• Extend آستانه «منبع بسیار کوتاه» ندارد: بر پایه اندازه‌گیری، یک قطعه 9.6 ثانیه‌ای که از ثانیه 5 ادامه داده شد به‌طور عادی آهنگ ساخت، پس کوتاه‌بودن منبع یا باقی‌مانده دلیل رد نیست.
• نقطه شروع باید بزرگ‌تر از 0 باشد: مقدار continueAt=0 توسط پلتفرم پذیرفته و سپس باطل می‌شود، بدون بازگرداندن علت شکست؛ پس درست پس از ثانیه نخست شروع کنید.
• یک فراخوانی 2 نتیجه برمی‌گرداند (به‌عنوان 2 آهنگ حساب می‌شود)؛ ملاک طول آرایه clips است.
• نتیجه یک اثر جدید است؛ آهنگ اصلی تحت تأثیر قرار نمی‌گیرد.