الانتقال إلى المحتوى الرئيسي

نظرة عامة

يتيح توليد الموسيقى بالذكاء الاصطناعي للمبدعين إنشاء موسيقى عالية الجودة دون الحاجة إلى معرفة موسيقية متخصصة. تمثل Suno و Producer مسارين مختلفين لتوليد الموسيقى بالذكاء الاصطناعي، ويتم استدعاؤهما موحدًا عبر Ace Data Cloud.

الخدمات المعنية

  • Suno: POST https://api.acedata.cloud/suno/audios
  • Producer: POST https://api.acedata.cloud/producer/audios

الحل التقني

الشروط المسبقة

  1. التسجيل في Ace Data Cloud
  2. الحصول على API Token
  3. تثبيت Python 3.7+ ومكتبة requests

خطوات التنفيذ

الخطوة 1: اختيار محرك الموسيقى

تدعم Suno توليد أغاني بأنماط متعددة، بينما يركز Producer (FUZZ) على إنتاج موسيقى عالية الدقة.

الخطوة 2: توليد الموسيقى

تستخدم Suno المسار /suno/audios، ويستخدم Producer المسار /producer/audios.

الخطوة 3: تخصيص الكلمات

قم بتعيين custom: true وقدم حقل lyric لتوليد موسيقى بكلمات مخصصة.

مثال على الكود

فيما يلي مثال كامل باستخدام Suno بلغة Python:
import requests

API_TOKEN = "YOUR_API_TOKEN"

def call_suno():
    response = requests.post(
        "https://api.acedata.cloud/suno/audios",
        headers={
            "Authorization": f"Bearer {API_TOKEN}",
            "Content-Type": "application/json",
        },
        json={
    "action": "generate",
    "prompt": "A cheerful pop song about summer vacation",
    "model": "chirp-v5",
    "custom": false
},
    )
    return response.json()

result = call_suno()
print(result)

أفضل الممارسات

  • إعادة المحاولة عند الخطأ: استخدام التراجع الأسي لإعادة المحاولة عند أخطاء 429 (تحديد المعدل) و 5xx
  • المعالجة غير المتزامنة: للمهام التي تستغرق وقتًا طويلاً (توليد الصور/الفيديو)، استخدم callback_url لاستلام النتائج بشكل غير متزامن
  • التحكم في التكلفة: راقب الاستخدام والتكاليف عبر لوحة تحكم Ace Data Cloud
  • أمان التوكن: خزّن API Token في متغيرات البيئة ولا تقم بتضمينه مباشرة في الكود

روابط ذات صلة