البدء السريع
ابدأ التوليد بثلاثة أسطر برمجية فقط. اختر لغتك:
curl https://www.flixly.ai/api/v1/generate \
-H "Authorization: Bearer flx_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-dev",
"prompt": "A cat wearing a top hat, oil painting",
"type": "TEXT_TO_IMAGE"
}'مرجع الـ endpoints
جميع الـ endpoints مسبوقة بـ https://www.flixly.ai. انقر على أي endpoint لعرض الأمثلة.
المصادقة
تتطلب جميع طلبات الـ API رمز Bearer داخل ترويسة Authorization الخاصة بكل طلب.
كيفية الحصول على مفتاح API
- سجّل الدخول إلى Flixly عبر www.flixly.ai/auth/login
- انتقل إلى لوحة التحكم ← الإعدادات ← مفاتيح API
- انقر على «Create API Key» وامنحه اسمًا
- انسخ المفتاح (يبدأ بـ
flx_live_) — فهو يُعرض مرة واحدة فقط
استخدام المفتاح
# أضفه إلى ترويسة كل طلب
Authorization: Bearer flx_live_YOUR_KEYاحتفظ بمفتاح API سرًّا. لا تضعه في شيفرة تعمل على جانب العميل ولا في مستودعات عامة.
حدود المعدّل
ترتفع الحدود مع خطتك. يمكنك الترقية في أي وقت من صفحة الفوترة.
| الخطة | الطلبات / دقيقة | المهام المتوازية |
|---|---|---|
| Free | 10 | 1 |
| Lite | 30 | 2 |
| Pro | 60 – 200 | 3 – 25 |
عند تجاوز حد المعدّل ستتلقى استجابة 429 مع ترويسة Retry-After تُبيّن عدد الثواني التي يجب انتظارها.
رموز الأخطاء
تتبع جميع الأخطاء بنية JSON موحّدة:
{
"error": {
"code": "insufficient_credits",
"status": 402,
"message": "You need at least 10 credits for this model."
}
}| الرمز | الحالة | الوصف |
|---|---|---|
unauthorized | 401 | مفتاح API غير صالح أو مفقود. |
insufficient_credits | 402 | لا توجد أرصدة كافية لإتمام الطلب. |
forbidden | 403 | مفتاح API لا يملك صلاحية تنفيذ هذا الإجراء. |
not_found | 404 | المورد المطلوب غير موجود. |
validation_error | 422 | فشل التحقق من صحة جسم الطلب. راجع الحقول المطلوبة. |
rate_limit_exceeded | 429 | عدد الطلبات كبير جدًا. أعد المحاولة بعد المدة الموضّحة في الترويسات. |
internal_error | 500 | خطأ غير متوقع في الخادم. تواصل مع الدعم إذا استمر. |