الانتقال إلى المحتوى الرئيسي
POST
إنشاء موسيقى
أرسل model وprompt إلى POST /v1/music/generate لتحصل على مقطوعة من أي مزوّد موسيقى عبر شكل طلب واحد. يتولى Phaseo عنك التعامل مع المزوّدين المتزامنين واستطلاع قوائم انتظار المزوّدين.

اقرأ النتيجة

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

اضبط خيارات Suno

تأخذ نماذج Suno كائن suno اختياريًا: يكون prompt مطلوبًا عندما تكون قيمة customMode هي false، وعندما تكون true مع ضبط instrumental على false. يُرجع الطلب الذي يخالف قاعدة لدى المزوّد 400:

التفويضات

Authorization
string
header
مطلوب

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

الجسم

application/json
model
string
مطلوب
models
string[]

نماذج احتياطية اختيارية ومرتبة تُجرَّب بعد model. الحقل model مطلوب وهو دائمًا النموذج الأساسي. عندما تفشل محاولة بالرمز 429 أو 500 أو 502 أو 503 أو 504، تُجرَّب الإدخالة التالية؛ وتُعاد الأخطاء الأخرى دون تغيير. يقبل ما يصل إلى 25 معرّف نموذج أو إعدادًا مسبقًا؛ وتُتجاهل الإدخالات المكررة والإدخالات المطابقة لـ model. يُتحقق من كل محاولة وتُسجَّل وتُحتسب تكلفتها كطلب مستقل، ويعرض الحقل model في الاستجابة وتتبّع التوجيه النموذج الذي خدم الطلب. لا تنتقل طلبات البث إلى نموذج احتياطي إلا قبل إرسال البايت الأول، ولا تنتقل مهام الفيديو والموسيقى إلا عند الإرسال. ترفض طلبات batch وrealtime وcouncil الحقل models. تكون الأولوية للنماذج الاحتياطية المحددة في مسار ديناميكي، ولا يمكن الجمع بين phaseo/auto وmodels.

Required array length: 1 - 25 elements
Minimum string length: 1
مثال:
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
آخر تعديل في ١٦ نوفمبر ٢٠٢٦