API بارگذاری صدای منبع

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

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

بارگذاری صدای منبع یک فایل صوتی محلی یا از راه دور را به کلیپ منبعی تبدیل می‌کند که قابلیت‌های بعدی می‌توانند از آن استفاده کنند: کاور، تمدید، جایگزینی بخش، جداسازی و موارد دیگر.

نقطه پایانی: POST /api/music/upload-source

صورت‌حساب: رایگان. این نقطه پایانی فقط صدای منبع را بارگذاری می‌کند و کار تولید را شروع نمی‌کند.

روش استفاده توصیه‌شده: این گام 1 «کاور دو مرحله‌ای» است. ابتدا صدا را با این نقطه پایانی بارگذاری کنید (رایگان است و در صورت خطا هر زمان می‌توانید دوباره تلاش کنید) و clip_id برگشتی را ذخیره کنید؛ پس از تأیید موفقیت بارگذاری (status در حالت کامل)، API کاور از کلیپ منبع را برای شروع کاور فراخوانی کنید — بدنه آن درخواست فقط چند صد بایت است، بنابراین به‌خاطر بزرگ بودن صدا در مسیر قطع نمی‌شود. در مقایسه با API یک‌مرحله‌ای بارگذاری و سپس کاور، این تفکیک زمانی پایدارتر است که صدا بزرگ باشد، شبکه ناپایدار باشد، یا همان ماده چند بار استفاده شود (تمدید / جایگزینی / جداسازی).

توصیه‌هایی برای بارگذاری فایل‌های بزرگ

پس از پایان بارگذاری، همیشه تأیید کنید که status در پاسخ در حالت کامل است و clip_id را ذخیره کنید و سپس به گام 2 بروید؛ بارگذاری ناموفق هزینه‌ای ندارد و کار تولیدی ایجاد نمی‌کند — فقط دوباره تلاش کنید.

پارامترهای درخواست

Headers

برای درخواست‌های JSON:

در درخواست‌های multipart Content-Type را دستی تنظیم نکنید؛ کلاینت آن را خودکار می‌سازد.

پارامترهای بدنه

نمونه درخواست JSON

curl -X POST https://www.suno-api.io/api/music/upload-source \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "file_url": "https://example.com/source.mp3",
    "file_name": "source.mp3",
    "upload_type": "file_upload"
  }'

نمونه درخواست multipart

curl -X POST https://www.suno-api.io/api/music/upload-source \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@source.mp3" \
  -F "file_name=source.mp3" \
  -F "upload_type=file_upload" \
  -F "model=suno-v6"

پاسخ

{
  "clip_id": "uploaded_clip_id",
  "status": "complete",
  "title": "source.mp3",
  "image_url": "https://...",
  "audio_url": "https://...",
  "display_tags": "pop, vocal",
  "inferred_description": "uploaded source audio",
  "clip_metadata": {}
}