API تولید/دریافت WAV
توضیح نقطه پایانی
نقطه پایانی WAV آدرس صدای WAV بدون افت برای یک آهنگ موجود را می‌سازد یا دریافت می‌کند.
نقطه پایانی: POST /api/music/wav
صورت‌حساب: رایگان. این نقطه پایانی آدرس WAV یک آهنگ موجود را می‌سازد یا دریافت می‌کند و اعتبار کم نمی‌کند.
زمان‌های انتظار و مهلت‌ها (مهم): این نقطه پایانی همزمان است — سفارش تنها زمانی پذیرفته می‌شود که پاسخ برسد. بر پایه اندازه‌گیری، بیشتر درخواست‌ها در 1-3 ثانیه پاسخ می‌دهند، حدود 10% بیش از 30 ثانیه طول می‌کشند و طولانی‌ترین حدود 230 ثانیه است. مهلت سمت کلاینت را 300 ثانیه یا بیشتر بگذارید؛ نبود پاسخ به معنای تولید نشدن نیست، و بلافاصله پس از مهلت دوباره تلاش نکنید. اگر اتصال قطع شد، بعداً با
GET /api/music/songsبررسی کنید. بخش «زمان‌های انتظار و تنظیم مهلت» در مرور کلی API جدید را ببینید.
پارامترهای درخواست
Headers
| پارامتر | نوع | الزامی | یادداشت |
|---|---|---|---|
| Authorization | string | بله | Bearer YOUR_API_KEY |
| Content-Type | string | بله | application/json |
پارامترهای بدنه
| پارامتر | نوع | الزامی | پیش‌فرض | یادداشت |
|---|---|---|---|---|
| model | string | بله | - | نسخه مدل، مثلاً suno-v6 |
| audioId | string | بله | - | شناسه آهنگ |
| maxAttempts | number | خیر | 24 | حداکثر تعداد تلاش‌های پرس‌وجو |
| intervalSeconds | number | خیر | 5 | فاصله پرس‌وجو بر حسب ثانیه |
maxAttempts و intervalSeconds هر دو عدد JSON هستند؛ intervalSeconds بر حسب ثانیه است، نه میلی‌ثانیه، و معمولاً همان مقادیر پیش‌فرض کافی است. این دو فقط تعداد و فاصله انتظار داخلی این نقطه پایانی برای آماده شدن WAV را کنترل می‌کنند و وضعیت خودِ کار تولید را تغییر نمی‌دهند.
نمونه درخواست
curl -X POST https://www.suno-api.io/api/music/wav \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"audioId": "clip_id",
"maxAttempts": 24,
"intervalSeconds": 5
}'
پاسخ
{
"code": 200,
"message": "success",
"data": {
"audioId": "clip_id",
"status": "complete",
"wavUrl": "https://media.code-go.com/assets/example.wav"
}
}
نکات
ساخت و بررسی WAV را سرور به‌طور خودکار بر پایه رکورد آهنگ انتخاب می‌کند؛ مشتری نیازی به دادن اطلاعات حساب ندارد.
آهنگ‌های معمولی و ترک‌های جداشده از همان مسیر تحویل رسانه کنترل‌شده استفاده می‌کنند. WAV ابتدا توسط CN2 دانلود و روی دیسک ذخیره می‌شود و data.wavUrl در پاسخ موفق فقط یک نشانی CDN کنترل‌شده برمی‌گرداند — هرگز نشانی موقت منبع Suno یا S3 را برنمی‌گرداند.
اگر یک دارایی WAV در وضعیت ready از قبل وجود داشته باشد، همان دوباره استفاده می‌شود، بدون درخواست مجدد از Suno و بدون جابه‌جایی دوباره فایل‌ها. WAV هنوز آماده‌نشده از طریق /api/music/query به‌عنوان نشانی Suno/S3 افشا نمی‌شود؛ تنها پس از فراخوانی این نقطه پایانی یا نقطه پایانی دانلود یکپارچه، در صورت نیاز آماده می‌شود.
⚠️ اعتبار نشانی WAV: 7 روز — به‌موقع ذخیره کنید. مقدار
data.wavUrlبرگشتی توسط فضای ذخیره‌سازی شیئی پلتفرم ارائه می‌شود و به‌طور پیش‌فرض پس از 7 روز منقضی می‌شود (فایل بازیافت می‌شود و نشانی قدیمی 404 برمی‌گرداند). WAV را در این بازه در فضای ذخیره‌سازی خودتان ذخیره کنید؛ پس از انقضا، این نقطه پایانی را دوباره فراخوانی کنید تا نشانی معتبر تازه بگیرید.
اگر منبع آهنگ موقتاً در دسترس نباشد، نقطه پایانی 409 برمی‌گرداند. بعداً دوباره تلاش کنید؛ سرور نشانی‌های موقت ناپایدار برنمی‌گرداند.
دریافت کلید API
پس از ثبت‌نام از کنسول یک کلید API بسازید. هر تولید ۰٫۶ یوان هزینه دارد و ۲ قطعه برمی‌گرداند، دانلودها نامحدود است و به شماره تلفن نیازی نیست.
دریافت کلید API بازگشت به مرور کلی