Skip to main content
قم بتوليد الموسيقى والكلمات باستخدام الذكاء الاصطناعي. هذه API غير متزامنة. تعيد استجابة الإنشاء هوية المهمة، وقد تتضمن أيضًا poll_url مفضلًا عند توفره.

جسم الطلب

string
افتراضي:"suno_music"
النموذج المستخدم: suno_music لتوليد الموسيقى، و suno_lyrics للكلمات فقط.
string
وصف الموسيقى. مطلوب لطلبات music و lyrics و upload-cover و upload-extend؛ ويمكن حذفه مع add-instrumental.
string
عنوان الأغنية التي تم توليدها.
string
علامات النمط (مثل: “pop, upbeat, electronic”).
string
الأنماط المطلوب تجنبها. مطلوب عندما تكون audio_operation هي add-instrumental.
string
نوع التوليد: MUSIC (افتراضي) أو LYRICS.
string
إصدار نموذج Suno الرسمي. مطلوب لتوليد الموسيقى (عند حذف action أو استخدام MUSIC)؛ اتركه في طلبات الكلمات فقط. القيم المدعومة: chirp-v3-5, chirp-v4, chirp-v4-5, chirp-v4.5, chirp-v4-5plus, chirp-v4.5plus, chirp-v4-5all, chirp-v4.5all, chirp-v5, chirp-v5-5, chirp-v5.5.
boolean
اضبطه على true لإنشاء نتيجة موسيقية بلا غناء.
string
رابط صوت مرجعي أو مرفوع يمكن الوصول إليه علناً. عند إرساله من دون audio_operation يستخدم TokenLab تدفق upload-cover.
string
وضع الصوت المرفوع: upload-cover أو upload-extend أو add-instrumental. يتطلب upload-extend الحقل continue_at؛ ويتطلب add-instrumental الحقول audio_url و title و tags و negative_tags.
string
معرف (ID) لمقطع سابق للمتابعة منه.
number
الطابع الزمني بالثواني الذي يبدأ منه الامتداد. مطلوب عندما تكون audio_operation هي upload-extend.

الاستجابة

string
معرف المهمة (Task ID) للاستعلام عن الحالة.
string
الاسم البديل لمعرّف المهمة غير المتزامنة عندما يعيده المهايئ.
string
رابط polling المفضّل عندما يكون متاحًا.
string
حالة المهمة: pending أو processing أو completed أو failed.
integer
طابع Unix الزمني لوقت إنشاء المهمة.