API حذف آواز
توضیح نقطه پایانی
حذف آواز یک آهنگ موجود را به دو ترک تقسیم می‌کند: آواز و موسیقی همراهی. این شکل کوتاه جداسازی است: فقط شناسه آهنگ منبع را می‌فرستید، نیازی به انتخاب حالت جداسازی نیست و سرور همیشه به‌صورت دو ترک (two) پردازش می‌کند.
نقطه پایانی: POST /api/music/vocal-removal
صورت‌حساب: رایگان. این نقطه پایانی فقط ترک‌ها را جدا می‌کند؛ هزینه‌ای برای تولید ایجاد نمی‌شود و رکورد کسر هم ثبت نمی‌شود.
مدل پیشنهادی: suno-v6. می‌توان از suno-v6، suno-v6-wild و suno-v6-mini استفاده کرد.
احراز هویت
| پارامتر | نوع | الزامی | یادداشت |
|---|---|---|---|
| Authorization | string | بله | Bearer YOUR_API_KEY |
| Content-Type | string | بله | application/json |
پارامترهای درخواست
| پارامتر | نوع | الزامی | پیش‌فرض | یادداشت |
|---|---|---|---|---|
| model | string | بله | - | نام مدل برای مشتری: suno-v6، suno-v6-wild یا suno-v6-mini |
| source_clip_id | string | بله | - | song_id واقعی آهنگ منبع؛ باید کامل شده و برای کلید API فعلی قابل دسترسی باشد |
| source_audio_url | string | خیر | - | نشانی صدای منبع (اگر منبع به حساب دیگری تعلق داشته باشد، سرور آن را منتقل می‌کند و کلاینت نیازی به ارسال ندارد) |
| source_file_name | string | خیر | - | نام فایل منبع؛ فقط برای گزارش‌ها و نمایش استفاده می‌شود |
| song_title | string | خیر | - | پیشوند عنوان نتیجه؛ به‌طور پیش‌فرض عنوان آهنگ منبع حفظ می‌شود |
نام‌های جایگزین سازگار: sourceClipId، audio_id، audioId و song_id همگی می‌توانند جای source_clip_id استفاده شوند.
نمونه درخواست
curl -X POST https://www.suno-api.io/api/music/vocal-removal \
-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": "vocals_clip_id",
"song_title": "حذف آواز (Vocals)",
"status": "pending",
"stem_from_id": "source_song_id",
"stem_mode": "two"
},
{
"song_id": "instrumental_clip_id",
"song_title": "حذف آواز (Instrumental)",
"status": "pending",
"stem_from_id": "source_song_id",
"stem_mode": "two"
}
]
}
}
هر ارسال 2 نسخه × {Vocals, Instrumental} برمی‌گرداند، بنابراین clips معمولاً 4 عضو دارد. بر پایه stem_from_id گروه‌بندی کنید و آواز را از موسیقی همراهی با پسوند song_title تشخیص دهید.
نکات
- ترک‌های نتیجه را با API پرس‌وجوی آهنگ و تاریخچه (
POST /api/music/query) تا رسیدن بهcompletedپرس‌وجو کنید و سپس استفاده کنید؛GET /api/music/songs/:song_idو فهرست تاریخچه در حال حاضر ترک‌های ساخته‌شده توسط حذف آواز را شامل نمی‌شوند — این یک تفاوت شناخته‌شده است. - اگر می‌خواهید حالت دو ترک یا چند ترک را انتخاب کنید یا بر پایه نام ترک جدا کنید، از API جداسازی (آواز و موسیقی همراهی) استفاده کنید.
- ترک‌های ناخواسته را می‌توان با API حذف ترک پنهان کرد؛ درخواست حذف را تکراری ارسال نکنید.
دریافت کلید API
پس از ثبت‌نام از کنسول یک کلید API بسازید. هر تولید ۰٫۶ یوان هزینه دارد و ۲ قطعه برمی‌گرداند، دانلودها نامحدود است و به شماره تلفن نیازی نیست.
دریافت کلید API بازگشت به مرور کلی