API ساخت آهنگ کامل (Get Full Song)

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

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

ساخت آهنگ کامل «آهنگ اصلی + قطعه تازه‌تولیدشده» را به یک آهنگ کامل تبدیل می‌کند: پس از Extend بخش بعدی اضافه می‌شود و پس از Replace Section قطعه جدید دوباره به اصل دوخته می‌شود. رابط وب رسمی این قابلیت را Get Full Song می‌نامد.

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

صورت‌حساب: پرداختی، به‌صورت ثابت 0.05 یوان برای هر فراخوانی. دوختن از قیمت تولید جدا است و در Max Mode یا ضریب‌های پروفایل صدا شرکت نمی‌کند؛ مبلغی که واقعاً کسر می‌شود تابع پیکربندی قیمت در پنل مدیریت است.

زمان‌های انتظار و مهلت‌ها (مهم): این نقطه پایانی همزمان است — سفارش تنها زمانی پذیرفته و به دوختن سپرده می‌شود که پاسخ برسد. مهلت سمت کلاینت را 300 ثانیه یا بیشتر بگذارید؛ نبود پاسخ به معنای دوخته نشدن نیست، و بلافاصله پس از مهلت دوباره تلاش نکنید (سفارش را تکرار می‌کند و دوباره هزینه می‌گیرد). اگر اتصال قطع شد، بعداً با GET /api/music/songs بررسی کنید.

احراز هویت

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

audio_id، source_clip_id و sourceClipId نوشتارهای معادل song_id هستند؛ هر یک را استفاده کنید.

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

curl -X POST https://www.suno-api.io/api/music/concat \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "song_id": "extended_or_replaced_clip_id",
    "is_infill": false
  }'

برای دوختن پس از جایگزینی یک بخش، is_infill را true بگذارید:

{ "song_id": "infilled_clip_id", "is_infill": true }

پاسخ

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "concat_clip_id",
        "song_title": "عنوان آهنگ منبع",
        "status": "queued"
      }
    ]
  }
}

دوختن فقط 1 نتیجه برمی‌گرداند (یکجا 2 آهنگ نمی‌سازد). مقدار clips[].song_id را ذخیره کنید و با API پرس‌وجوی آهنگ و تاریخچه تا رسیدن به complete پرس‌وجو کنید و سپس صدا را بگیرید.

مدت زمان نتیجه از کجا می‌آید

دوختن دو فایل را ساده پشت سر هم نمی‌چسباند؛ آهنگ منبع را بر پایه نقاط زمانی ثبت‌شده در تاریخ قطعه می‌بُرد:

بنابراین صدای اصلی پس از نقطه ادامه کنار گذاشته می‌شود و هیچ بخشی به‌طور کامل تکرار نمی‌شود.

نکات

• فقط قطعه‌های کامل‌شده را می‌توان دوخت؛ اگر قطعه‌ای هنوز در حال تولید است ابتدا منتظر پایان آن بمانید.
• نتیجه یک رکورد جدید است و قطعه اصلی همچنان حفظ می‌شود و قابل استفاده است.
• برای ترکیب دو آهنگ متفاوت در یکی از API میکس و برای نگه‌داشتن تنها یک بخش از API برش استفاده کنید.