إضافة الموسيقى المُنشأة بالذكاء الاصطناعي إلى منتج كان يعني سابقًا ترخيص مكتبة موسيقى جاهزة أو توظيف ملحن. في عام 2026، يمكنك استدعاء Suno v4.5 والحصول على أغنية كاملة مدتها 4 دقائق مع غناء، تناغم وإنتاج — في حوالي 60 ثانية من وقت التنفيذ، بأقل من $0.50.

هذا المنشور يشرح عملية التكامل الكاملة، من أول استدعاء curl إلى تسليم الصوت عبر webhook في تطبيقك.

1. الحصول على مفتاح API

سجل في aimarcus.eu/aigenerate/register. $10 مجانًا عند التسجيل تكفي لحوالي 20 أغنية باستخدام Suno v4.5 لتبدأ.

2. بدء عملية الإنشاء

POST https://aimarcus.eu/aigenerate/api/v1/generate
Authorization: Bearer sk-aig-YOUR_KEY
Content-Type: application/json

{
  "model": "V4_5",
  "prompt": "Upbeat synthwave, driving bass, retro 80s vibe",
  "customMode": false,
  "instrumental": false,
  "callBackUrl": "https://your-app.com/webhooks/suno"
}

الاستجابة:

{ "code": 200, "data": { "taskId": "f0147a2e78670ecbce46020219f931a1" } }

3. كلمات مخصصة

قم بتعيين customMode: true وأضف كلماتك في الحقل prompt. Suno يتولى اللحن، التوزيع، التناغم والأداء الصوتي.

{
  "model": "V4_5",
  "customMode": true,
  "prompt": "[Verse 1]\nWaking up to a city that never sleeps...",
  "style": "indie pop ballad",
  "title": "Midnight City",
  "callBackUrl": "..."
}

4. الاستطلاع أو webhook

خياران:

  • الاستطلاع: GET /api/v1/generate/record-info?taskId=... كل 5 ثوانٍ حتى state="success". نقاط نهاية الاستطلاع مجانية — لا تُحسب ضمن حد معدل الاستخدام أو التكلفة.
  • Webhook: قم بتوفير callBackUrl. عندما تكون الأغنية جاهزة، نقوم بإرسال JSON النتيجة إلى عنوان URL الخاص بك مع توقيع HMAC-SHA256 في X-AI-Signature.

5. الحمولة النهائية

الإكمال الناجح يُرجع رابطين صوتيين (Suno يُنشئ تنويعات):

{
  "data": {
    "state": "success",
    "response": {
      "sunoData": [
        { "audioUrl": "https://.../track-a.mp3", "duration": 185 },
        { "audioUrl": "https://.../track-b.mp3", "duration": 194 }
      ]
    }
  }
}

كلاهما بصيغة MP3، 44.1 كيلوهرتز، جاهز للتشغيل. الروابط تبقى متاحة إلى أجل غير مسمى، ولكن للإنتاج يجب عليك تنزيلها وإعادة استضافتها على شبكة CDN الخاصة بك.

6. نصائح للإنتاج

  • قم بالتخزين المؤقت على شبكة CDN الخاصة بك — روابط Suno سريعة ولكنك تتحكم في مستوى الخدمة الخاص بك عند الاستضافة.
  • احفظ taskId في قاعدة البيانات الخاصة بك مرتبطًا بطلب المستخدم — يجعل التكرار والتدقيق أمرًا بسيطًا.
  • قم بتعيين حد إنفاق يومي في إعدادات لوحة التحكم إذا كنت تعرض هذه الخدمة للمستخدمين النهائيين.
  • للسرد الصوتي بأسلوب البودكاست، استخدم نموذج تحويل النص إلى كلام مخصص بدلاً من ذلك (أسرع وأرخص من Suno).

هذا هو الدورة الكاملة. نفس النمط يعمل مع Suno v3.5، v4، v4.5 Plus، MusicGen و Mureka — فقط قم بتغيير الحقل model.