API پیشنهادهای پرامپت

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

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

نقطه پایانی پیشنهادهای پرامپت، توصیف آهنگ، موضوع متن و پیشنهاد برچسب سبک را به‌صورت تصادفی برمی‌گرداند. برای دکمه‌های «الهام تصادفی» و «تازه‌سازی برچسب‌ها» مناسب است.

نقطه پایانی: POST /api/prompts/suggestions

صورت‌حساب: در سهمیه رایگان است (حداکثر 10 فراخوانی در دقیقه و 300 در روز برای هر کاربر)؛ پس از عبور از سهمیه رایگان 0.1 یوان برای هر فراخوانی.

تشخیص عبور از حد: با عبور از سهمیه رایگان، درخواست همچنان عادی اجرا می‌شود و هدرهای پاسخ شامل X-Suno-Helper-Free: false و X-Suno-Helper-Over-Limit: minute (یا day) هستند، تا کلاینت بتواند اطلاع دهد که این فراخوانی هزینه‌دار شده است.

مدل پیشنهادی: suno-v6. می‌توان از suno-v6، suno-v6-wild و suno-v6-mini استفاده کرد.

احراز هویت

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

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

curl -X POST https://www.suno-api.io/api/prompts/suggestions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6"
  }'

پاسخ

{
  "code": 200,
  "message": "success",
  "data": {
    "prompts": ["A dreamy synth-pop track about city lights after rain"],
    "lyrics_prompts": ["متن فارسی درباره شب، دیدار دوباره و پشیمانی بنویس"],
    "tags": ["dreamy synth-pop", "warm piano", "male vocal"],
    "is_pending_personalization": false
  }
}

توضیح فیلدها