Midjourney

يدعم Tianshu استدعاء Midjourney لتوليد الصور عبر واجهة Midjourney proxy API القياسية (imagine لتحويل النص إلى صورة، وupscale لرفع الدقة، وvariation للتنويعات، وما إلى ذلك). تندرج نماذج Midjourney ضمن مجموعة midjourney.

التحضير

1. أنشئ رمزًا في مجموعة midjourney من لوحة التحكم.
2. توليد Midjourney مهمة طويلة التنفيذ، لذا استخدم المسار المباشر https://api.tian-shu.org لنقطة النهاية.

مسار الاستدعاء

Midjourney مهمة غير متزامنة: أرسل أولًا مهمة للحصول على معرّف المهمة، ثم استعلم دوريًا عن نتيجة المهمة.

1. إرسال مهمة تحويل النص إلى صورة

curl 'https://api.tian-shu.org/mj/submit/imagine' \
  -H 'Authorization: Bearer your-midjourney-group-token' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "a cozy bookstore on a rainy night, warm light, cinematic --ar 16:9 --v 6"
  }'

تتضمّن الاستجابة معرّف مهمة id.

2. الاستعلام عن نتيجة المهمة

curl 'https://api.tian-shu.org/mj/task/TASK_ID/fetch' \
  -H 'Authorization: Bearer your-midjourney-group-token'

عندما تصبح حالة المهمة status مساوية لـ SUCCESS، تتضمّن الاستجابة عنوان URL للصورة المكتملة (شبكة 2×2).

3. رفع الدقة / التنويع

بمجرد أن تصبح الشبكة جاهزة، استخدم معلومات الأزرار المُعادة لإرسال الإجراءات التالية (رفع الدقة U1–U4، التنويع V1–V4):

curl 'https://api.tian-shu.org/mj/submit/action' \
  -H 'Authorization: Bearer your-midjourney-group-token' \
  -H 'Content-Type: application/json' \
  -d '{
    "taskId": "the task ID from the previous step",
    "customId": "the button customId returned in the previous step"
  }'

معاملات التوجيه الشائعة

Parameter	Notes
--ar 16:9	نسبة العرض إلى الارتفاع (مثل 1:1، 16:9، 9:16).
--v 6	إصدار النموذج.
--niji	نموذج بأسلوب الأنمي.
--style raw	أكثر واقعية، وأقل تنميقًا.
--no xxx	استبعاد عناصر معينة.

استخدامه في عميل

يمكن لأي عميل صور من طرف ثالث يدعم صيغة "Midjourney proxy / midjourney-proxy" استخدام:

• نقطة النهاية: https://api.tian-shu.org
• مفتاح API: رمز مجموعة midjourney الخاص بك

للاطّلاع على النماذج والمستويات المتاحة تحديدًا (fast / relax، وما إلى ذلك)، راجع مجموعة midjourney على سوق النماذج.