API Speed (تغییر سرعت)

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

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

Speed سرعت پخش یک آهنگ موجود را تغییر می‌دهد و می‌تواند زیروبمی را حفظ کند.

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

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

مدل پیشنهادی: 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/speed \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "source_clip_id": "source_song_id",
    "speed_multiplier": 1.2,
    "keep_pitch": true,
    "song_title": "نسخه با سرعت تغییر‌یافته"
  }'

پاسخ

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "result_song_id",
        "song_title": "نسخه با سرعت تغییر‌یافته",
        "status": "processing"
      }
    ]
  }
}

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

نکات

• speed_multiplier باید مثبت و حداکثر با چهار رقم اعشار باشد؛ بیشتر از آن پیش از هر صورت‌حساب HTTP 400 برمی‌گرداند.
• مدت نتیجه تقریباً برابر مدت اصلی تقسیم بر ضریب سرعت است.