لم تبقَ واجهة API الخاصة بالمطورين في Freepik تحمل هذا الاسم طويلًا. فمنذ أواخر أبريل 2026 تُباع المنصة كاملة، بما فيها مكتبة الأصول وأدوات الذكاء الاصطناعي، تحت اسم Magnific، ولم يعد عنوان الوثائق القديم سوى تحويل إلى docs.magnific.com. إذا كنت تخطط لميزانية واجهة API لتوليد الصور بالذكاء الاصطناعي لمنتج ما، فإن تغيير الاسم أقل أهمية من قائمة الأسعار التي تقوم عليها، لأن فاتورتك تتكون من جزأين مختلفين جدًا: مولّد صور رخيص (Mystic إلى جانب قائمة طويلة تضم نماذج Flux ونماذج Seedream) وأداة رفع دقة يتبع سعرها حجم المخرجات بالبكسل.
يعرض هذا المقال ما تذكره الوثائق الرسمية، وما تنشره مواقع تتبع الأسعار الخارجية، وأين يختلف الاثنان، حتى تتمكن من تقدير تكلفة شهرية فعلية قبل كتابة أي سطر من كود التكامل. كل ما هو موسوم بـ موثّق مصدره الوثائق الرسمية. وكل ما هو موسوم بـ مُبلَّغ عنه مصدره جهات خارجية، ويستحق التحقق منه في لوحة التحكم الخاصة بك.
Freepik أصبحت الآن Magnific
تؤرّخ عدة مقالات تسعير منشورة في 2026 التحول إلى 28 أبريل 2026، حين أصبحت Magnific العلامة الموحّدة للأصول الجاهزة للاستخدام ولمجموعة أدوات ذكاء اصطناعي تشمل الصور والفيديو والصوت وثلاثي الأبعاد والتصميم. بالنسبة إلى مستخدمي واجهة API، الآثار الظاهرة صغيرة لكنها حقيقية.
ما الذي يغيّره التحول إلى الاسم الجديد
- عنوان التوثيق: يردّ
docs.freepik.com بإعادة توجيه دائمة إلى docs.magnific.com (موثّق).
- ترويسة المصادقة: تسمّي الوثائق الحالية الترويسة باسم Magnific بدلًا من Freepik (موثّق).
- الخوادم القديمة: يذكر أحد المقالات الذي حُدّث في أواخر سبتمبر 2026 أن
api.freepik.com وapi.magnific.com ما زالا مقبولين أثناء الانتقال (مُبلَّغ عنه).
💡 نصيحة: ضع اسم الخادم وأسماء الترويسات في ملف إعدادات واحد. عندها يصبح التغيير القادم في الاسم تعديلًا من سطر واحد بدلًا من البحث في قاعدة الكود كلها.
نقاط النهاية التي ستستدعيها
ثلاث نقاط نهاية تقوم تقريبًا بكل العمل في مشاريع الصور. وكل واحدة منها غير متزامنة: ترسل مهمة، فتتسلم task_id وحالة، ثم تستعلم عن النتيجة أو تترك webhook_url يستدعيك عند الانتهاء. تنتقل مهام Mystic من CREATED إلى IN_PROGRESS، وتنتهي إما بحالة مكتملة أو بحالة FAILED (موثّق).
| المهمة | الطريقة والمسار | ملاحظات |
|---|
| التوليد باستخدام Mystic | POST /v1/ai/mystic | تحويل نص إلى صورة، مع مراجع اختيارية للأسلوب والبنية |
| رفع الدقة الإبداعي | POST /v1/ai/image-upscaler | يمكنه ابتكار تفاصيل جديدة، ويُوجَّه بأمر نصي |
| رفع الدقة الدقيق | POST /v1/ai/image-upscaler-precision | يحافظ على المحتوى الأصلي دون تفاصيل مبتكرة |
يتبع التكامل النموذجي الخطوات الأربع نفسها مع الثلاث جميعها:
- أرسل الطلب مع أمرك النصي أو رابط صورة المصدر، ويفضَّل أن تضيف
webhook_url.
- احفظ
task_id المُعاد بجانب سجلك الخاص، مثل طلب أو معرّف منتج.
- انتظر إشعار webhook، أو استعلم عن نقطة نهاية المهمة على فترات معتدلة.
- نزّل المخرجات فورًا واحفظها في مخزنك الخاص.

كيف تفرض واجهة API الفوترة
أول ما يجب حسمه هو الرصيد الذي يدفع ثمن استدعاءاتك. الخلط بينهما خطأ سهل في الميزانية مع واجهة API هذه.
نقاط وليست اشتراكات
تنص الوثائق على أن كل طلب بالذكاء الاصطناعي، سواء كان صورة أو فيديو أو صوتًا أو رفع دقة أو تعديلًا، يخصم النقاط من رصيد مؤسستك (موثّق). الخطط الموجهة للمستهلكين منتج مختلف. تذكر مواقع التتبع أن خطة Premium تُكلّف €12 شهريًا عند الدفع السنوي مع 240,000 نقطة سنويًا، وأن خطة Premium+ تُكلّف €27 شهريًا مع 600,000 نقطة (مُبلَّغ عنه). تصف عدة مقالات الواجهة بأنها خدمة مطورين منفصلة ومدفوعة مسبقًا، لذلك تأكد من الرصيد الذي تُخصم منه طلباتك قبل النشر. طريقة رخيصة للتحقق: شغّل توليدًا واحدًا بدقة 1K باستخدام Mystic، ثم قارن الرصيد قبل التوليد وبعده. هذا الاختبار الواحد يمنحك سعر الصورة الواحدة الخاص بك، مقيسًا على حسابك.
أسعار الصورة الواحدة من مواقع التتبع
تنشر الوثائق الرسمية جدول أسعار لأداة رفع الدقة، لكنها لا تنشر جدولًا لأسعار التوليد لكل نموذج. الأرقام التالية مصدرها مواقع تتبع الأسعار الخارجية، فاعتبرها تقديرًا أوليًا.
| النموذج | السعر المُبلَّغ عنه لكل صورة |
|---|
| Classic Fast | $0.005 |
| Flux Dev | $0.012 |
| Flux 2 Pro (1K) | $0.04 |
| Flux Kontext Pro | $0.04 |
| Flux Pro 1.1 | $0.043 |
| HyperFlux | $0.161 |
⚠️ انتبه للقيم الشاذة: ما زال أحد المقالات الذي حُدّث في أواخر سبتمبر 2026 يذكر أن توليد Mystic يكلّف 0.40 لكل 100 عملية، أي نحو 0.004 لكل عملية. وهذا أقل بنحو عشر مرات تقريبًا من سعر Flux 2 Pro المذكور أعلاه. فجوة بهذا الحجم سبب وجيه لقراءة قائمة الأسعار المباشرة قبل وضع الميزانية.
الرصيد المجاني والسقف الإنفاقي
تذكر المقالات أن هناك 5 كرصيد مجاني للبداية تقريبًا (باليورو في مقال، وبالدولار في آخر)، وسقفًا ذاتيًا للخدمة يبلغ 500 شهريًا قبل أن تضطر إلى التواصل مع فريق المبيعات (مُبلَّغ عنه). إذا كان مشروعك يحتاج أكثر من ذلك، فاطلب اتفاقًا مخصصًا مبكرًا، لأن الصفحات نفسها تذكر أن الحدود الأعلى تمر عبر فريق المبيعات.

Mystic وكتالوج النماذج
Mystic هو محرك Freepik الداخلي لتحويل النص إلى صورة، وقائمة معاملاته طويلة بما يكفي لتستحق جدولًا خاصًا.
معاملات Mystic التي تستحق المعرفة
| المعامل | القيم | الافتراضي |
|---|
resolution | 1k، 2k، 4k | 2k |
aspect_ratio | 13 إعدادًا مسبقًا مثل widescreen_16_9، social_story_9_16، classic_4_3 | square_1_1 |
model | zen، flexible، fluid، realism، super_real، editorial_portraits | realism |
engine | automatic، magnific_illusio، magnific_sharpy، magnific_sparkle | automatic |
creative_detailing | من 0 إلى 100 | 33 |
fixed_generation | true أو false | false |
structure_reference، style_reference | صورة Base64 | لا شيء |
filter_nsfw | true أو false | true |
هناك تفصيلتان توفران وقت تصحيح الأخطاء. أولًا، تقبل الأوامر النصية مراجع الشخصيات المكتوبة على هيئة @character_name أو @character_name::strength. ثانيًا، لا يمكن إيقاف filter_nsfw للمستخدمين العاديين، لذلك لن يمرّ محتوى للبالغين عبر واجهة API هذه إطلاقًا. من حيث الاسم، يشير super_real و editorial_portraits إلى الأعمال الفوتوغرافية، بينما تبدو zen و fluid أقرب إلى المخرجات ذات الطابع اللوحي. شغّل دفعة اختبار صغيرة لكل منها قبل أن تلتزم بواحد، باستخدام الأمر النصي نفسه في كل مرة، بحيث يكون النموذج هو المتغير الوحيد.
نماذج أخرى لتحويل النص إلى صورة
إلى جانب Mystic، تذكر الوثائق Flux Kontext Pro و Flux 2 Pro و Flux 2 Turbo و Flux 2 Klein وFlux Pro 1.1 وFlux Dev وHyperflux وSeedream 4 وSeedream 4.5 وZ-Image Turbo، إضافة إلى نقطة نهاية لتحويل النص إلى صورة من Runway (موثّق). هذا التنوع هو الميزة الحقيقية: تكامل واحد ورصيد واحد، ومولّدات كثيرة.
تلمّح الأسماء إلى المهام المقصودة. ينتمي Kontext Pro إلى سلسلة Flux Kontext، المبنية حول تعديل صورة موجودة بتعليمات نصية. وتشير إصدارات Turbo و Klein إلى السرعة وانخفاض التكلفة للصورة الواحدة. ويُعد Seedream 4.5 و Flux 2 Pro اختيارين شائعين للصور التسويقية المصقولة. ولأن الكتالوج يتغير بسرعة، اقرأ قائمة النماذج المباشرة قبل أن تثبّت اسم نموذج في الكود، واحتفظ بالاسم في ملف الإعدادات لا في كودك المصدري.

أسعار Magnific Upscaler حسب الحجم
هنا تكبر الفاتورة. يدعم الوضعان عوامل 2x و4x و8x و16x، ويُسعَّر كلاهما حسب مساحة المخرجات بالبكسل، لا حسب عدد الاستدعاءات (موثّق).
الوضع الإبداعي
تقبل نقطة النهاية الإبداعية scale_factor وoptimized_for وprompt وcreativity وhdr وresemblance وfractality وengine وwebhook_url. وفي الممارسة العملية تتصرف كمولّد يُوجَّه بصورتك، فتضيف ملمسًا وعمقًا لم يكن موجودًا في المصدر. وهذا يناسب الرسوم التوضيحية وأعمال الفن المفاهيمي والصور الناعمة التي تحتاج إلى دفعة. لكنه غير مناسب للوجوه التي يجب أن تبقى مطابقة للأصل، ولأي صورة تحتوي على نص، لأن التفاصيل المبتكرة قد تغيّر الاثنين.
توصي الوثائق بإرسال الصورة الأصلية عبر الرابط كلما أمكن. فالرفع بصيغة Base64 وتصدير عناصر canvas يفقدان الجودة قبل أن تراهما أداة رفع الدقة.

وضع الدقة
يكبّر وضع الدقة، الذي أُطلق في منتصف 2025 بحسب المراجعات، الصورة دون أن يبتكر محتوى جديدًا. وهو الخيار الأأمن للشعارات ولقطات الواجهات والصور الخاصة بالمنتجات والمسوحات الضوئية. وتوصي الوثائق بمدخل لا يقل عن 256 إلى 512 بكسل على الحافة الأقصر، وبصيغة PNG للرسوم، وبصيغة JPEG أو PNG عالية الجودة للصور الفوتوغرافية، وبعوامل معتدلة من 2x إلى 4x، لأن الدفع أبعد من ذلك يميل إلى تضخيم الضوضاء.
طريقة سريعة للاختيار بين الوضعين:
| صورة المصدر لديك | الوضع الأفضل | السبب |
|---|
| شعار أو أيقونة أو لقطة واجهة | الدقة | يجب ألا تتغير الحواف والحروف |
| صورة منتج لكتالوج | الدقة | يتوقع العميل الصنف الحقيقي |
| مسح قديم أو صورة مضغوطة بشدة | الإبداعي، بقوة منخفضة | الملمس المفقود يجب أن يأتي من مكان ما |
| رسم توضيحي أو فن مفاهيمي | الإبداعي | التفاصيل الإضافية مرحّب بها |
| صورة شخص حقيقي | الدقة، أو الإبداعي بقوة منخفضة | التفاصيل المبتكرة قد تبتعد عن الوجه |

ماذا تكشف نقاط الأسعار الثلاث
تقدم الوثائق ثلاثة أمثلة محسوبة، وهي متطابقة لكلا الوضعين. أعمدة الميغابكسل من إضافتي أنا، لإظهار النمط.
| المدخل | المخرج | العامل | التكلفة | حجم المخرج | التكلفة لكل ميغابكسل |
|---|
| 640×480 | 1280×960 | 2x | €0.10 | 1.23 MP | حوالي €0.081 |
| 1920×1080 | 3840×2160 | 2x | €0.20 | 8.29 MP | حوالي €0.024 |
| 640×480 | 5120×3840 | 8x | €0.50 | 19.66 MP | حوالي €0.025 |
من ثلاث نقاط فقط، يبدو أن أمرين محتملان (استنتاجي أنا، وليس صيغة منشورة). فالمخرجات الصغيرة يبدو أنها تستقر عند حد أدنى قرب عشرة سنتات، والمخرجات الكبيرة تستقر عند نحو سنتين ونصف لكل ميغابكسل. والدرس العملي: صورة صغيرة مرفوعة الدقة بعامل 8x تكلّف أكثر من إطار Full HD مرفوع الدقة بعامل 2x، لذلك حدّد الحجم البكسلي النهائي قبل أن تختار العامل.

حدود الطلبات والمحاذير
سقوف الطلبات والروابط المنتهية
الحدود الموثّقة سخية لمعظم المشاريع (موثّق):
- لكل عنوان IP: 50 طلبًا في الثانية خلال نافذة مدتها 5 ثوانٍ، ومتوسط 10 طلبات في الثانية خلال 2 دقيقة.
- لكل بيانات اعتماد: 30,000 طلب في الدقيقة.
- الحدود اليومية: لا توجد لمعظم نقاط النهاية. وبعض الخدمات المساعدة، مثل تحويل الصورة إلى أمر نصي والبحث، تقتصر على 100,000 طلب يوميًا.
- حدود مخصصة: متاحة عبر فريق المبيعات.
تهم أرقام كل عنوان IP إذا كان أسطول العمّال يشارك عنوانًا صادرًا واحدًا. إذ يرسل 10 عمّال كل منهم خمسة طلبات في الثانية، فسيتجاوزون بكثير المتوسط البالغ 10 طلبات في الثانية خلال 2 دقيقة. أضف طابور انتظار صغيرًا وتراجعًا أُسّيًا (exponential backoff) عند تقييد الطلب، فيصبح الحد غير ملحوظ لمستخدميك.
الحد الذي يسبب المتاعب فعلًا ليس معدلًا على الإطلاق. تنتهي صلاحية روابط المخرجات بعد 30 دقيقة من التوليد، لذلك انسخ كل نتيجة إلى تخزينك الخاص لحظة إبلاغ المهمة بالانتهاء. وفضّل استخدام webhooks بدلًا من حلقات الاستعلام المتسارعة، وسجّل كل مهمة بحالة FAILED حتى تعيد محاولتها قبل انتهاء النافذة.

حسابات الميزانية لمشاريع حقيقية
كتالوج من 1,000 صورة
لنفترض أن متجرًا إلكترونيًا يريد 1,000 صورة لمنتجاته، يُولَّد كل منها مرة واحدة ويُرفع دقته إلى 4K. باستخدام سعر Flux 2 Pro المُبلَّغ عنه وسعر أداة رفع الدقة الموثّق:
| الخطوة | سعر الوحدة | العدد | الإجمالي |
|---|
| التوليد باستخدام Flux 2 Pro بدقة 1K | $0.04 | 1,000 | حوالي $40 |
| رفع الدقة من 1920×1080 إلى 3840×2160 | €0.20 | 1,000 | €200 |
| رفع الدقة لأفضل 200 صورة فقط | €0.20 | 200 | €40 |
يكلّف رفع الدقة تقريبًا خمسة أضعاف تكلفة التوليد، لذا فأرخص توفير هو الانتقاء: اختر الفائزين أولًا وارفع دقة هذه الصور فقط. والصور المصغّرة الصغيرة تتصرف بالطريقة نفسها. رفع دقة 5,000 صورة من 640×480 إلى 1280×960 بسعر 0.10 يورو لكل صورة يبلغ 500 يورو، وهو يساوي السقف الشهري للخدمة الذاتية المذكور سابقًا.
💡 نصيحة: ولّد الصور بالدقة التي تحتاجها، وتجاوز أداة رفع الدقة عندما تكفي مخرجات 2k للتصميم. كل رفع دقة تتجنبه يوفّر سعر وحدة كاملًا.
خمس عادات تُبقي الفاتورة ثابتة مع نمو الحجم:
- ارفع دقة الصور المعتمدة فقط. لا تشغّل أداة رفع الدقة على مسودة أبدًا.
- ابدأ بعامل 2x. انتقل إلى 4x أو 8x فقط عندما يتطلب التصميم الفعلي هذه البكسلات.
- سجّل كل مهمة. احفظ معرّف المهمة والنموذج وحجم المخرج وتكلفة كل مشروع، حتى يمكن تتبع أي مفاجأة في الفاتورة خلال دقائق.
- أضف هامشًا بنسبة 10 إلى 15 بالمئة لإعادة التشغيل عندما لا تطابق النتيجة الموجز.
- احفظ المخرجات فور وصولها. الرابط الذي تنتهي صلاحيته بعد 30 دقيقة يعني إعادة تشغيل تدفع ثمنها مرتين.

نماذج Picasso IA المناسبة
إذا أردت مقارنة الجودة قبل الالتزام بأي واجهة API، فإن Picasso IA يستضيف بدائل قريبة لشقّي سير العمل، ويمكنك تجربتها في المتصفح أولًا.
بدائل تحويل النص إلى صورة
بدائل أداة رفع الدقة
هذا التقابل تقابل في الروح لا في الهوية. لكل نموذج مظهره الخاص، لذا شغّل الصورة نفسها للاختبار عبر نموذجين أو ثلاثة قبل أن تحكم.
كيفية استخدام Clarity Pro Upscaler
يُعد Clarity Pro Upscaler أقرب تطابق للوضع الإبداعي في Magnific بفضل عنصر التحكم الوحيد في الإبداع. فهو يحافظ على البنية الوجهية ومسام البشرة وخصل الشعر أثناء التكبير.
- افتح صفحة النموذج وارفع الصورة. الصورة هي المدخل الوحيد المطلوب.
- اضبط
scale_factor. القيمة الافتراضية 2. اختر 2 أو 4 أو 8 أو 16 حسب الحجم المستهدف.
- عدّل
creativity. القيمة الافتراضية 0. القيم السالبة تبقى قريبة من الأصل، والقيم الموجبة تضيف ملمسًا وعمقًا.
- اختر
output_format. صيغة PNG بلا فقدان وهي الافتراضية. أما JPG فتستخدم جودة 95% وتعطي ملفات أصغر.
- شغّل النموذج ونزّل النتيجة. احفظها فورًا.
💡 نصيحة: ابدأ بعامل 2x مع الإبداع عند 0، ثم ارفع إعدادًا واحدًا في كل مرة. تغيير المقياس والإبداع معًا يصعّب معرفة أيهما سبب التغيير.
جرّب ذلك على Picasso IA
يمكن للمطورين أيضًا استدعاء Picasso IA برمجيًا. تقع واجهة API الخاصة به على https://api.picassoia.com/v1، وتتبع النمط نفسه المتبع في سير Freepik أعلاه: أنشئ تنبؤًا، ثم استعلم عنه، ثم احصل على النتيجة. وقت كتابة هذا المقال كانت تقدم أربعة نماذج (توليد الصور، وتعديل الصور، والفيديو، والفيديو مع الصوت) مع 5 تنبؤات متزامنة لكل حساب. لم يكن نص الموقع حول التكلفة ومتطلبات الخطط متسقًا في ذلك الوقت، لذا تأكد منه في صفحة الأسعار قبل أن تبني عليه.
لاختبار سريع دون أي تكامل، خذ صورة ناعمة منخفضة الدقة، وشغّلها عبر Clarity Pro Upscaler بعامل 2x، ثم جرّب Topaz Image Upscale على الملف نفسه. وولّد صورة جديدة باستخدام Flux 2 Pro، ومرّرها عبر الخطوات نفسها. خلال فترة بعد الظهر ستعرف أي مظهر يناسب مشروعك، وستكون لديك أرقام حقيقية للمقارنة مع قائمة أسعار Magnific. اختر صورة، وافتح نموذجًا، وشغّل اختبارك الأول اليوم.
