API تولید افکت صوتی
توضیح نقطه پایانی
تولید افکت صوتی چند ثانیه صدا می‌سازد، نه یک آهنگ. برای صداهای کوتاه مانند رعد، قطره باران یا صدای برخورد مناسب است و برای افکت‌های گذار، صدای محیط و لوپ درام هم کار می‌کند؛ بیشتر زیر 5 ثانیه و بلندترین حدود 20 ثانیه است. دو حالت یک‌بار و حلقه‌ای پشتیبانی می‌شود.
نقطه پایانی: POST /api/music/sounds
صورت‌حساب: پرداختی، در حال حاضر به‌طور پیش‌فرض 0.6 یوان برای هر فراخوانی. مبلغی که واقعاً کسر می‌شود تابع پیکربندی قیمت فعلی در پنل مدیریت است.
زمان‌های انتظار و مهلت‌ها (مهم): این نقطه پایانی همزمان است — سفارش تنها زمانی پذیرفته و به تولید سپرده می‌شود که پاسخ برسد. بر پایه اندازه‌گیری، بیشتر درخواست‌ها در 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 | نام مدل برای مشتری: suno-v6، suno-v6-wild یا suno-v6-mini |
| description | string | بله | - | صدای مورد نظر را توصیف کنید؛ عبارت‌های کوتاه انگلیسی پایدارترین نتیجه را می‌دهند، مثلاً cinematic whoosh transition, bright impact |
| title | string | خیر | - | عنوان؛ اگر ارسال نشود می‌تواند از توضیح ساخته شود |
| type | string | خیر | one_shot | نوع: one_shot (یک‌بار) یا loop (حلقه‌ای) |
| loop | boolean | خیر | false | آیا حلقه‌ای پخش شود؛ معادل تنظیم type روی loop |
| bpm | number | خیر | - | BPM؛ باید عددی بزرگ‌تر از 0 باشد. مقدار نامعتبر 400 (invalid_sound_bpm) برمی‌گرداند و بی‌صدا نادیده گرفته نمی‌شود |
| key | string | خیر | - | مقام، به شکل نام نت (C-B) + #/b اختیاری + Major/Minor اختیاری، مثلاً C Major یا C#m یا Bb؛ خالی یا any یعنی بدون محدودیت. مقدار نامعتبر 400 (invalid_sound_key) برمی‌گرداند |
نمونه درخواست
curl -X POST https://www.suno-api.io/api/music/sounds \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"description": "cinematic whoosh transition, bright impact",
"title": "cinematic whoosh",
"type": "one_shot",
"loop": false,
"bpm": 120,
"key": "C"
}'
پاسخ
آرایه‌ای از آهنگ‌ها برگردانده می‌شود؛ فیلدها همان فیلدهای عمومی پاسخ آهنگ در مرور کلی API جدید است.
دریافت کلید API
پس از ثبت‌نام از کنسول یک کلید API بسازید. هر تولید ۰٫۶ یوان هزینه دارد و ۲ قطعه برمی‌گرداند، دانلودها نامحدود است و به شماره تلفن نیازی نیست.
دریافت کلید API بازگشت به مرور کلی