API Fade in / out (محو شدن)

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

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

Fade in/out به یک آهنگ موجود اثر بلندشدن تدریجی (fade-in) یا کم‌شدن تدریجی (fade-out) اضافه می‌کند.

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

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

مدل پیشنهادی: suno-v6. می‌توان از suno-v6، suno-v6-wild و suno-v6-mini استفاده کرد.

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

احراز هویت

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

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

curl -X POST https://www.suno-api.io/api/music/fade \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "source_clip_id": "source_song_id",
    "direction": "out",
    "duration_seconds": 3,
    "song_title": "نسخه با محو شدن"
  }'

پاسخ

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "result_song_id",
        "song_title": "نسخه با محو شدن",
        "status": "processing"
      }
    ]
  }
}

هر فراخوانی 1 نتیجه برمی‌گرداند (عملیات ویرایشی دو آهنگ نمی‌سازد). مقدار clips[].song_id را ذخیره کنید و با API پرس‌وجوی آهنگ تا رسیدن به completed پرس‌وجو کنید.

نکات

• direction تنها in یا out را می‌پذیرد؛ هر درخواست فقط یک جهت را می‌تواند مشخص کند.
• duration_seconds باید بزرگ‌تر از 0 باشد و واحد آن ثانیه است.