API Reverse (معکوس)

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

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

Reverse یک آهنگ موجود را برعکس پخش می‌کند و نسخه‌ای جدید می‌سازد.

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

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

مدل پیشنهادی: 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/reverse \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "source_clip_id": "source_song_id",
    "song_title": "نسخه معکوس"
  }'

پاسخ

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "result_song_id",
        "song_title": "نسخه معکوس",
        "status": "processing"
      }
    ]
  }
}

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

نکات

• source_clip_id باید شناسه آهنگ واقعی، کامل‌شده و قابل دسترس برای کلید API فعلی باشد.
• مدت نتیجه معمولاً برابر با آهنگ منبع است.