تخطَّ إلى المحتوى
UlazAI

مستندات المطور UlazAI

توليد الصوت API

التسعير لوحة القيادة استوديو الصور

API استوديو الموسيقى

Suno API

أنشئ أغانٍ وتابع العمل عليها عبر API نفسها التي يستخدمها استوديو الموسيقى.

افتح استوديو الموسيقى

اطّلع على كتالوج العمليات لمعرفة النماذج الحالية والحقول المطلوبة والأسعار بالأرصدة. أرسل معرف طلب فريدًا حتى لا تُحصَّل الرسوم مرتين عند إعادة المحاولة.

GET  /api/v1/music/studio/catalog/
POST /api/v1/music/studio/jobs/
GET  /api/v1/music/studio/jobs/
GET  /api/v1/music/studio/jobs/<id>/
POST /api/v1/music/studio/upload/

تتضمن مكتبتك جميع المقاطع المعادة. التعديل ينشئ نتيجة جديدة ويحتفظ بالأصل.

توليد الصوت API

قم بإنشاء الموسيقى والتعليقات الصوتية والمؤثرات الصوتية باستخدام أرصدة UlazAI. يتم تسليم النتائج بشكل غير متزامن: أرسل مهمة، ثم قم باستقصاء نقطة نهاية الحالة حتى تكتمل.

التوثيق: استعمال Authorization: Bearer <ulazai_api_key> أو Authorization: Token <token>.

🎵 موسيقى

بريد /api/v1/music/generate/ المصادقة مطلوبة

قم بإنشاء مقطوعة موسيقية من prompt.

هيئة الطلب

{
  "prompt": "Upbeat synthwave track with neon retro vibes",
  "model": "V5",               // Options: "V5", "V4_5PLUS" (default: V4_5PLUS)
  "duration": 30,              // Optional (seconds)
  "instrumental": true,        // Optional (default: true)
  "title": "Neon Nights",      // Optional
  "style": "synthwave, 120bpm" // Optional
}

الاستجابة (تم إنشاء 201)

{
  "success": true,
  "data": {
    "music_id": "uuid-here",
    "status": "processing",
    "status_url": "/api/v1/music/status/uuid-here/",
    "credits_used": 12,
    "credits_remaining": 88
  }
}

تكلفة الائتمان: 12 الاعتمادات لكل طلب.

احصل على /api/v1/music/status/<music_id>/ المصادقة مطلوبة

استطلاع لاستكمال المهمة.

الاستجابة (200 موافق، مكتملة)

{
  "success": true,
  "data": {
    "music_id": "uuid-here",
    "status": "completed",
    "audio_url": "https://media.ulazai.com/...",
    "credits_used": 12
  }
}

🎙️ تعليق صوتي

بريد /api/v1/voiceover/generate/ المصادقة مطلوبة

تحويل النص إلى تعليق صوتي.

نص الطلب (تحويل النص إلى كلام)

{
  "model": "tts_turbo_25",     // Options: "tts_turbo_25", "tts_v3"
  "text": "Welcome to UlazAI Studio. Let's create something amazing.",
  "voice": "Rachel",          // Optional
  "speed": 1.0                // Optional (0.7 - 1.2)
}

نص الطلب (الحوار)

{
  "model": "dialogue_v3",
  "dialogue": [
    {"voice": "Rachel", "text": "We need a new hook for this ad."},
    {"voice": "Roger",  "text": "Let's make it shorter and punchier."}
  ]
}

تكلفة الائتمان: على أساس عدد الأحرف. توربو 2.5: 12 الاعتمادات لكل 1000 حرف. الإصدار 3/الحوار: 14 الاعتمادات لكل 1000 حرف.

احصل على /api/v1/voiceover/status/<voiceover_id>/ المصادقة مطلوبة

استطلاع للاكتمال واسترداد عنوان URL الصوتي.

🔊 المؤثرات الصوتية

بريد /api/v1/sound-effects/generate/ المصادقة مطلوبة

قم بإنشاء مؤثر صوتي من prompt.

هيئة الطلب

{
  "text": "A futuristic UI beep with a short tail",
  "loop": false,
  "duration_seconds": 2.5
}

تكلفة الائتمان: 0,24 الاعتمادات / ثانية (تقريب)، الحد الأدنى 1 الائتمان.

احصل على /api/v1/sound-effects/status/<sfx_id>/ المصادقة مطلوبة

استطلاع للاكتمال واسترداد عنوان URL الصوتي.