Skip to main content
POST
إنشاء موسيقى
إنشاء الموسيقى عبر واجهة API واحدة مستقلة عن المزوّد. ويتولى Phaseo معالجة الاستجابات المتزامنة واستطلاع قوائم انتظار المزوّدين في الخلفية. عند اكتمال التوليد، تتضمن الاستجابة audio_url أو audio_base64. وإذا أعاد المزوّد مهمة غير نهائية، فاستخدم id نفسه من الاستجابة مع GET /music/generate/{music_id}.

بنية الطلب

خيارات Suno

  • suno.customMode (قيمة منطقية، الافتراضي false)
  • suno.instrumental (قيمة منطقية، الافتراضي false)
  • suno.prompt (تجاوز اختياري لـ prompt في المستوى الأعلى)
  • suno.style, suno.title (مطلوب عندما تكون customMode = true)
  • suno.personaId, suno.personaModel
  • suno.negativeTags, suno.vocalGender
  • suno.styleWeight, suno.weirdnessConstraint, suno.audioWeight

قواعد التحقق

  • عندما تكون customMode = false، يكون prompt مطلوبًا.
  • عندما تكون customMode = true، يكون كل من style وtitle مطلوبًا.
  • عندما تكون customMode = true وinstrumental = false، يكون prompt مطلوبًا.
تعيد أخطاء التحقق 400 مع:

الاستجابة

  • id هو معرّف طلب Phaseo الثابت. استخدمه لاسترجاع الطلب عبر GET /music/generate/{music_id}.
  • nativeResponseId هو معرّف مزود الخدمة الأصلي، ويُستخدم لربط الطلب بالمزود وطلب الدعم منه.
  • يمكن أن تكون قيمة status هي queued أو in_progress أو completed أو failed.
  • قد يتضمن usage الحقل output_audio_seconds عندما يبلغ المزود عن مدة الصوت المُنشأ.

التفويضات

Authorization
string
header
مطلوب

المصادقة باستخدام رمز Bearer

الجسم

application/json
model
string
مطلوب
prompt
string
duration
integer
format
enum<string>
الخيارات المتاحة:
mp3,
wav,
ogg,
aac
provider
object

تفضيلات توجيه المزوّد لاختياره عبر البوابة.

suno
object
elevenlabs
object
echo_upstream_request
boolean
debug
object

عناصر تحكم تصحيح أخطاء البوابة. لا تُمرر هذه العلامات إلى المزوّد مطلقًا.

الاستجابة

200 - application/json

استجابة إنشاء الموسيقى

id
string
مطلوب

معرّف طلب ثابت من Phaseo يُستخدم مع GET /music/generate/{music_id}.

object
enum<string>
مطلوب
الخيارات المتاحة:
music
status
enum<string>
مطلوب
الخيارات المتاحة:
queued,
in_progress,
completed,
failed
model
string
مطلوب
provider
string
مطلوب
nativeResponseId
string | null

معرّف المزوّد upstream لأغراض الربط والدعم.

audio_url
string<uri>
audio_base64
string
result
any

بيانات وصفية لنتيجة المزوّد بعد توحيدها بواسطة Phaseo.

output
object[]
usage
object
آخر تعديل في ٢ أكتوبر ٢٠٢٦