موسیقی
مدل Suno V6 در حالت ساده یا سفارشی. هر درخواست دو ترک برمیگرداند.
تولید موسیقی
یک تسک Suno V6 ارسال میشود و اعتبار آن کسر میشود. هر درخواست دو ترک
کامل تولید میکند که هر دو در output برگردانده میشوند.
هدرها
Idempotency-Keyتلاش دوباره برای این ارسال را بیخطر میکند. تکرار درخواست ظرف 15 دقیقه،
body اصلی را با وضعیت 200 برمیگرداند و دوباره اعتباری کسر نمیشود؛ تکرار
در حالی که درخواست اول هنوز در حال پردازش است، 409 request_in_progress
برمیگرداند.
کلید همراه با پرامپت درخواست (در گفتار، دیالوگ آن) هویت درخواست را تعیین
میکند؛ پس استفاده دوباره از یک کلید با پرامپتی متفاوت، تولید جدیدی را
شروع میکند. فیلد client_request_id در body هم دقیقاً همینطور عمل
میکند.
تولید موسیقی › body درخواست
promptدر حالت ساده، توضیحی درباره ترک (حداکثر 3,000 کاراکتر). در حالت سفارشی، متن ترانه (حداکثر 5,000 کاراکتر).
modelاختیاری. هر مقدار خارج از کاتالوگ با خطای invalid_model رد میشود.
customModeبا false ترک را در prompt توصیف میکنید و بقیه کار را به مدل
میسپارید. با true، prompt متن ترانه است و style و title اعمال
میشوند.
styleژانر و سبک تنظیم. فقط در حالت سفارشی.
titleفقط در حالت سفارشی. به 79 واحد UTF-16 کوتاه میشود (هر ایموجی دو واحد حساب میشود) و اگر آن را نفرستید، از پرامپت یا سبک استفاده میشود.
instrumentalساخت ترک بدون آواز.
تولید موسیقی › پاسخها
تکرار درخواست با همان Idempotency-Key ظرف 15 دقیقه. body پاسخ
بایتبهبایت با پاسخ 202 اصلی یکسان است و دوباره اعتباری کسر نشده است.
idوضعیت را با GET /generations/{id}/ بررسی کنید.
typeنوع مدیای تسک.
modelمدل، همانطور که در درخواست فرستادهاید.
statusهمیشه processing؛ هنوز چیزی ساخته نشده است.
credits_chargedاز قبل کسر شده است. این قیمت نهایی است، بهجز در تسکهای edit/extend مدل seedance25 که این مبلغ رزرو اعتبار است و پس از تحویل، بخشی از آن بازگردانده میشود.
created_at