Skip to main content

فهم المفهوم الأساسي

تقوم MidJourney API بمحاكاة تفاعلات أزرار Discord. وعلى عكس REST APIs التقليدية، فهي تعمل كـ آلة حالات حيث تُرجع كل عملية أزرارًا جديدة للخطوة التالية.

واجهات API الأساسية الأربع


مخطط سير العمل الكامل


المفهوم الأساسي: الأزرار و customId

تعيد كل مهمة ناجحة مصفوفة buttons. ويحتوي كل زر على customId تستخدمه لتشغيل الإجراء التالي. مثال على استجابة من /mj/task/\{id\}/fetch:
customId ليست قيمة ثابتة. فهي تتغير مع كل مهمة. احصل عليها دائمًا من مصفوفة buttons.

مرجع الأزرار حسب المرحلة

بعد IMAGINE (صورة شبكية 4-grid)

تُعاد هذه الأزرار عند اكتمال إنشاء الصورة الأولية:

بعد UPSCALE (صورة واحدة)

بعد ترقية الدقة، ستحصل على إمكانية الوصول إلى أدوات التحرير:
ملاحظة: قد تختلف تسميات الأزرار وتنسيقات customId حسب إصدار MJ المحدد في prompt الخاص بك (على سبيل المثال، --v 6.1 مقابل --v 5.2). اقرأ الأزرار دائمًا من استجابة API.
زر Inpaint (Vary Region) لا يظهر إلا بعد Upscale.

مثال كامل: الإنشاء ثم ترقية الدقة

الخطوة 1: إرسال طلب imagine

الاستجابة:

الخطوة 2: الاستعلام الدوري عن حالة المهمة

الاستجابة (عند الاكتمال):

الخطوة 3: النقر على U1 لترقية الدقة

الاستجابة:

الخطوة 4: الاستعلام الدوري عن المهمة الجديدة والحصول على النتيجة


متى يكون Modal مطلوبًا؟

عندما تستدعي /mj/submit/action وتصبح حالة المهمة MODAL بدلًا من SUCCESS، يجب عليك استدعاء /mj/submit/modal لتقديم إدخال إضافي.

عمليات Modal المؤكدة

مثال: تدفق Inpaint

اختيار وضع السرعة

أضف بادئة السرعة إلى المسار:

نقاط دخول أخرى

واجهات API هذه هي نقاط دخول مستقلة ولا تتبع تدفق imagine ← action:

نصائح لاستكشاف الأخطاء وإصلاحها

استنادًا إلى تصميم API وسير العمل، إليك المشكلات الشائعة التي قد تواجهها: