API v1

وثائق FM9 API

أنشئ ميزات قوية لتوليد الموسيقى في تطبيقاتك باستخدام REST API الخاص بنا.

البداية السريعة

أنشئ مقطعك الأول باستدعاء API واحد.

Requestbash

curl -X POST https://api.fm9.ai/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "موسيقى إلكترونية راقصة نشيطة"}'

Responsejson

{
  "id": "gen_abc123",
  "status": "processing",
  "estimated_time": 30
}

المصادقة

جميع طلبات API تتطلب مفتاح API. قم بتضمين مفتاحك في رأس Authorization:

احصل على مفتاح API الخاص بك من لوحة تحكم المطورين.

Authorization: Bearer YOUR_API_KEY

نقاط النهاية

POST/v1/generate

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

إنشاء مهمة توليد موسيقى جديدة.

Parameters

prompt-وصف نصي للموسيقى المراد توليدها (مطلوب)
duration-مدة المقطع بالثواني (30-180، الافتراضي: 60)
style-إعداد مسبق لنمط الموسيقى (اختياري)
instrumental-توليد موسيقى آلية فقط (الافتراضي: false)

يُرجع كائن التوليد مع معرف المهمة والحالة.

GET/v1/generation/:id

الحصول على حالة التوليد

التحقق من حالة مهمة التوليد.

يُرجع كائن التوليد مع الحالة الحالية وروابط التنزيل عند الاكتمال.

GET/v1/generations

قائمة التوليدات

استرداد قائمة بسجل التوليد الخاص بك.

Parameters

limit-عدد النتائج المراد إرجاعها (الافتراضي: 20، الحد الأقصى: 100)
offset-إزاحة الصفحات (الافتراضي: 0)
status-التصفية حسب الحالة (pending, processing, completed, failed)

أسعار API

تسعير بسيط وشفاف على أساس الاستخدام.

المبتدئ

مجاني

10 توليدات/شهر

وصول أساسي لـ API
جودة قياسية
دعم المجتمع

المطور

$49/mo

500 توليد/شهر

وصول كامل لـ API
إخراج عالي الجودة
دعم ذو أولوية
استدعاءات Webhook

المؤسسات

مخصص

غير محدود

بنية تحتية مخصصة
نماذج مخصصة
ضمان SLA
دعم على مدار الساعة

حدود المعدل

لضمان الاستخدام العادل واستقرار الخدمة، تُطبق حدود المعدل التالية:

المبتدئ: 10 طلبات/دقيقة
المطور: 60 طلب/دقيقة
المؤسسات: حدود مخصصة

إذا تجاوزت حد المعدل، ستتلقى استجابة 429 Too Many Requests.

رموز الخطأ

يستخدم API رموز استجابة HTTP القياسية للإشارة إلى النجاح أو الفشل.

Code	Description
400	Bad Request - معلمات غير صالحة
401	Unauthorized - مفتاح API غير صالح أو مفقود
402	Payment Required - رصيد غير كافٍ
429	Too Many Requests - تم تجاوز حد المعدل
500	Internal Server Error - حدث خطأ من جانبنا

تحتاج مساعدة؟

فريق دعم المطورين لدينا هنا للمساعدة.

البريد الإلكتروني: [email protected]

الوثائق الكاملة متاحة على docs.fm9.ai