عن المشروع

Suno AI API هو مشروع مفتوح المصدر غير رسمي (مرخص بموجب LGPL-3.0) يوفر غلاف API لخدمة توليد الموسيقى Suno.ai. يسمح للمستخدمين بدمج قدرة توليد الموسيقى في وكلاء الذكاء الاصطناعي مثل GPTs وCoze وLangChain. الميزات الرئيسية: - ينفذ واجهة برمجة التطبيقات الكاملة لـ Suno.ai، بما في ذلك التوليد القائم على المطالبات، والوضع المخصص (مع التحكم في الكلمات والأسلوب والعنوان)، وتوليد الكلمات، وتمديد الصوت، وتوليد المسارات الأساسية، ودمج الأغاني. - يحل تحديات hCaptcha تلقائيًا باستخدام خدمة 2Captcha المدفوعة (أو ruCaptcha) وPlaywright مع rebrowser-patches. - يحافظ على نشاط حساب Suno في الخلفية. - يوفر تنسيق API متوافقًا مع OpenAI عبر `/v1/chat/completions`. - يدعم النشر بنقرة واحدة إلى Vercel، أو التنفيذ المحلي عبر Node.js، أو Docker (على الرغم من تعطيل تسريع GPU في Docker). الإعداد: لتشغيل الخدمة، يحتاج المستخدمون إلى توفير ملف تعريف ارتباط Suno (`SUNO_COOKIE`)، ومفتاح API لـ 2Captcha (`TWOCAPTCHA_KEY`)، وإعدادات المتصفح (مثل `BROWSER=chromium`، و`BROWSER_LOCALE=en`، و`BROWSER_HEADLESS=true`). يُنصح باستخدام أنظمة macOS لتقليل عدد تحديات CAPTCHA التي يتم مواجهتها. قدرات API: يكشف المشروع عن عدة نقاط نهاية REST، بما في ذلك `/api/generate`، و`/api/custom_generate`، و`/api/get` (لاسترجاع معلومات الموسيقى بالمعرف)، و`/api/get_limit` (للتحقق من الحصة)، و`/api/extend_audio`، و`/api/generate_stems`، و`/api/clip`، و`/api/concat`. كما يسمح بتجاوز ملفات تعريف الارتباط عبر رؤوس الطلبات لاستخدام حسابات متعددة في وقت واحد. يتم توفير أمثلة برمجية بلغة Python وJavaScript في ملف README لتوضيح الاستخدام.