Midjourney V8.2 API: إرسال مهمة صورة والاستعلام عن نتيجتها
أرسل مهمة صورة إلى Midjourney V8.2، واحفظ معرّفها، واستعلم عن النتيجة باستخدام Python. تعرّف إلى معاملات الإصدارات وعمليات الصور والأسعار الحالية.
اقرأ بصيغة Markdownيحتاج تكامل Midjourney V8.2 API إلى إصدار صريح وطلب صورة صالح وطريقة لاسترجاع المهمة المكتملة. مع SeedRouter، ترسل إلى /v1/images/generations، وتحتفظ بمعرّف المهمة المعاد، ثم تستعلم دوريًا من /v1/tasks/{id}. يؤكد نجاح الإرسال استلام المهمة؛ أما الصور فتصل ضمن النتيجة المكتملة.
يتبع هذا الدليل عقد طلبات SeedRouter. أكمل فحص مدفوع في 18 أكتوبر 2026 طلبًا لـ V8.2 بالوضع السريع، وسلّم أربع صور بأبعاد 1024 × 1024. الصورة الشخصية أدناه إحدى تلك النتائج. تضم صفحة النموذج أداة Playground والأسعار الحالية؛ ويميّز مرجع API بين المدخلات المدعومة والتركيبات التي ما زالت تحتاج إلى تحقق. [1]
ابدأ بطلب Midjourney V8.2 API يحدد الإصدار صراحةً
استخدم معرّف النموذج الكامل midjourney-v8.2. يتطلب SeedRouter نموذجًا صريحًا؛ فلا تختصره إلى midjourney ولا تستنتجه من إعداد حساب في واجهة أخرى. سجّل النموذج مع الطلب المرسل. [1]
حضّر مفتاح API على الخادم وموجّهًا قصيرًا بنتيجة تستطيع فحصها. ابدأ دون مراجع أو عمليات مرتبطة بصورة أصلية، ليختبر طلبك الأول المسار الأساسي. أنتج الطلب التالي مجموعة الصور الشخصية المعروضة. وهو يختار الوضع السريع ويفعّل فحص المحتوى الإضافي:
{
"model": "midjourney-v8.2",
"prompt": "Cinematic portrait of a young woman with freckles and wind-swept auburn hair, wearing a cream cable-knit sweater, laughing on a coastal cliff at golden hour, warm rim light, shallow depth of field, 85mm film photograph",
"speed": "fast",
"nsfw_check": true
}لا يحتاج الطلب الأدنى إلا إلى model وprompt؛ وتكون السرعة سريعة افتراضيًا عند إغفالها. إن أضفت size، فاستخدم نسبة عرض إلى ارتفاع مثل "16:9"، لا تعليمة بكسلات بصيغة WIDTHxHEIGHT. لا يطابق عقد هذا النموذج إعداد عام لعميل صور يرسل 1024x1024 أو quality: "high" أو قيمة n عشوائية. عدّل جسم الطلب اعتمادًا على جدول حقول Midjourney، بدل إعادة استخدام إعدادات نموذج آخر دون تغيير.
أرسل مرة واحدة، ثم استعلم عن معرّف المهمة المحفوظ
يستخدم مثال Python القابل للتنزيل المكتبة القياسية، ويحفظ المفتاح في متغير بيئة، ويكتب معرّف المهمة المقبولة في ملف محلي. ويفصل بين أمر الإرسال وأمر الاستعلام. يتيح هذا الفصل استئناف القراءة دون إنشاء مهمة صور أخرى.
export SEEDROUTER_API_KEY='your-server-side-key'
python3 midjourney-v8-2.py submit request.json --state mj-task.json
python3 midjourney-v8-2.py poll --state mj-task.jsonاحفظ طلب JSON أعلاه باسم request.json. استبدل مفتاح المثال بسرك الخاص في بيئتك المحلية؛ ولا تضعه في حزمة المتصفح أو تودعه في مستودع. لاختبار نشر محلي، اضبط SEEDROUTER_BASE_URL في المثال على عنوان الأساس /v1 لذلك النشر.
يرفض المثال الكتابة فوق ملف حالة قائم عند الإرسال. كما لا يكرر POST تلقائيًا بعد فشل الاتصال. إذا فُقدت الاستجابة، فقد لا يعرف التطبيق ما إذا قُبلت المهمة. راجع سجل المهام قبل اتخاذ قرار بإرسال الطلب مجددًا.
أما الاستعلام الدوري فيقرأ مهمة موجودة بالفعل. يتوقف المثال عند اكتمال المهمة أو فشلها، ويبلغ ببلوغ حد الانتظار إن استمرت المعالجة. حد الانتظار ملاحظة من جهة العميل، وليس دليلًا على ضرورة إعادة توليد المهمة.
اقرأ بنية النتيجة الخاصة بالعملية
تعيد عملية الصور المكتملة عناوين URL في output.data. مرّ على عناصر هذه المصفوفة بدل افتراض أنها تحتوي دائمًا أربعة عناصر. قد يعيد توليد الصور واختيار صورة ووصف صورة وخطوة إدخال التعديل أنواعًا مختلفة من المخرجات.
| حقل النتيجة | ما ينبغي أن يفعله التطبيق |
|---|---|
status | التمييز بين المهام قيد المعالجة والمكتملة والفاشلة |
output.data[].url | عرض كل صورة مُسلَّمة أو حفظها |
output.grid | تمييز الشبكة المُسلَّمة بوصفها شبكة؛ فقد يحتوي ملف واحد عدة خيارات صور |
output.text | عرض النص المعاد دون افتراض وجود أربعة اقتراحات أو أنه باللغة الإنجليزية |
output.seed | تسجيله عند وجوده، دون اشتراط تضمينه في كل نتيجة |
output.awaiting_input | متابعة سير إدخال التعديل الموثق |
تعامل مع المهمة الفاشلة كفشل في التطبيق، حتى لو نجح طلب HTTP المستخدم لقراءتها. نجاح HTTP يعني خدمة استعلام الحالة؛ ولا يعني أن الصورة المطلوبة قد وُلّدت.
عندما تكون output.grid مساوية لـ true، يحتوي عنوان URL واحد على الشبكة. لا تختلق أربعة عناوين منفصلة من ذلك الملف. يستخدم الاختيار اللاحق موضع الصورة في الشبكة، بدءًا من 1؛ ولا يساوي عدد العناوين عدد الخيارات المتاحة.
يطبع المثال الخرج المكتمل بصيغة JSON. يمكن لتطبيقك إضافة التخزين والصور المصغرة وعناصر الاختيار حول الصور المعادة. احتفظ بمعرّف المهمة مع هذه النتائج لتتمكن العملية اللاحقة من الإشارة إلى المهمة الأصلية الصحيحة.
حوّل المعاملات الأصلية دون إخفاء التعارضات
يقبل التكامل الحقول المنظمة وأعلام الموجّه الأصلية المدعومة. وتكون الأولوية للحقول المنظمة، ثم extra، ثم الأعلام داخل prompt. تُحفظ قيم الصفر وfalse الصريحة.
مثلًا، موجّه يحتوي --stylize 700 مع "stylize": 0 يستخدم الصفر الصريح. يفيد ذلك عندما ترسل الواجهة قيمة تحكم منفصلة، لكنه قد يفاجئ تطبيقًا يجمع الموجّهات وJSON في مواضع مختلفة. يُفضّل مصدر واحد لكل إعداد.
في طلبات SeedRouter لـ V8.2، يقبل quality القيم 0.25 أو 0.5 أو 1 أو 2 في التركيبات المتوافقة. الجودة وhd مدخلان مستقلان؛ فضبط الجودة لا يختار HD. راجع قيود التركيبات الحالية قبل إضافتهما معًا أو إضافة عناصر مرجعية أخرى؛ فالمدخل الموثق لا يثبت أثره في كل إصدار. كما أن Raw مستقل عنهما، ويوضح دليل Raw هذا الفرق. [1]
يتجاهل هذا التكامل حقول JSON غير المعروفة، لكنه يرفض الأعلام الأصلية غير المعروفة. لا تعتبر قبول الطلب دليلًا على أن حقل JSON إضافيًا غير ذي صلة غيّر الخرج. راجع أسماء الحقول الموثقة، واحفظ جسم الطلب المرسل حرفيًا في سجل الاختبار.
أبقِ عمليات الصورة الأصلية مرتبطة بمهمتها
استخدم parent_task_id الخاص بك في SeedRouter للعملية اللاحقة. تظل العملية التابعة مرتبطة بسياق التنفيذ الأصلي. إذا تعذّر استخدام ذلك السياق، تفشل العملية بدل إنشاء مهمة أصلية أخرى في مكان آخر. يجب أن تكون المهمة الأصلية مملوكة للحساب نفسه، وأن تستخدم النموذج نفسه، وأن تظل متاحة للعملية المطلوبة. تبدأ فهارس الصور العامة من 1.
اختيار صورة والتكبير الإبداعي عمليتان مختلفتان. لا ينبغي وصف نتيجة select بأنها تحسين للدقة. وبالمثل، التنويع وإعادة المزج وEdit Model الرسمي لـ V8.2 ميزات مستقلة بمتطلبات مختلفة.
لا يتيح التكامل الحالي Edit Model الجديد كعملية API متحقق منها. لا تستبدله بطلب inpaint قديم وتفترض أنه يقدم السلوك نفسه. يشرح دليل التعديل البدائل المتاحة وتسلسل تعديل بقناع تم التحقق منه في V6.1، ويسجّل مرجع API قيود العمليات المنفذة.
قدّر المهام بدل عدّ الصور المصغرة
التوليد المكتمل الواحد مهمة واحدة وفق عقد أسعار هذا التكامل. لا ينشئ اختيار صورة موجودة من شبكة توليدًا آخر قابلًا للفوترة. ولا يضيف الدخول إلى مرحلة إدخال التعديل رسوم توليد ثانية؛ فالعملية النهائية modal هي الخطوة المدفوعة. توليد أربع صور لا يعني تلقائيًا أربع مهام منفصلة الفوترة. أعاد فحص مسودة V8.2 في 18 أكتوبر عدد 24 صورة ضمن مهمة واحدة؛ لذلك ليس عدد الصور المعادة صيغة آمنة للتسعير.
استخدم السعر الحالي للإصدار والعملية والسرعة والوضع المحددين. قد ترث عمليات الصورة الأصلية إعدادات، لذا ينبغي حساب السعر من الطلب الفعلي لا من افتراضات عن القيم الافتراضية. تقرأ صفحة النموذج الأسعار المضبوطة بدل تضمين مبلغ دولاري ثابت في هذا الدليل.
في اختبار القبول، سجّل الطلب ومعرّف المهمة والحالة النهائية وعدد المخرجات والرسوم الفعلية على الحساب. لا يثبت نجاح البناء أو اختبار HTTP بمحاكاة هذه الحقائق التشغيلية. لا يفرض SeedRouter رسومًا على الطلبات الفاشلة.
أسئلة شائعة
هل يمكن استخدام مفتاح API نفسه في JavaScript بالواجهة الأمامية؟
احتفظ به على الخادم. اجعل المتصفح يستدعي نقطة نهاية في تطبيقك محمية بالمصادقة، ترسل الطلب باستخدام مفتاح الخادم.
هل يعني الحصول على معرّف مهمة أن الصورة جاهزة؟
لا. اقرأ المهمة حتى تبلغ عن اكتمالها أو فشلها، ثم عالج النتيجة المناسبة. احفظ المعرّف قبل بدء حلقة الاستعلام.
هل ينبغي أن تؤدي المهلة إلى توليد جديد؟
ليس تلقائيًا. احتفظ بأي معرّف معروف وافحص المهمة القائمة. لا تثبت مهلة الاتصال أو انتظار العميل أن الإرسال الأصلي رُفض.
هل يمكن تغيير الإصدار لعملية مرتبطة بصورة أصلية؟
يتطلب هذا التكامل النموذج نفسه المستخدم في المهمة الأصلية. ابدأ توليدًا منفصلًا عندما تريد تقييم إصدار آخر.
ابدأ تكامل Midjourney V8.2 API بطلب صريح واحد ومعرّف مهمة محفوظ. تحقّق من الخرج المُسلَّم والرسوم قبل إضافة المراجع أو سلسلة عمليات الصور.
المصادر
تمت مراجعة العقد وأدلة التنفيذ في 18 أكتوبر 2026. الصور المعروضة نتائج فحوص تكامل مدفوعة، وليست اختبار أداء عامًا للنموذج.