الوظيفة الرئيسية لواجهة برمجة التطبيقات Midjourney Shorten API هي الاتصال بأمرDocumentation Index
Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
Use this file to discover all available pages before exploring further.
/shorten الرسمي من Midjourney (تحليل Prompt)، لتحليل جزء من الـ Prompt، والتعرف على الكلمات المفتاحية ذات الوزن الأعلى، وإنشاء 5 مقترحات مختصرة أكثر للـ Prompt. هذه الواجهة مناسبة جداً لـ:
- تقليل طول الـ Prompt الطويل قبل استدعاء
imagineلزيادة دقة الصور الناتجة؛ - فهم وزن كل رمز (token) في Midjourney بشكل عكسي من خلال المقترحات، مما يسهل هندسة الـ Prompt؛
- دمجها مع خطوط العمل الآلية لتجميع الكلمات المفتاحية وتقليل طول الـ Prompt الذي يدخله المستخدم.
عملية التقديم
لاستخدام Midjourney Shorten API، يجب أولاً التقديم عبر صفحة التقديم Midjourney Shorten API، وبعد الدخول إلى الصفحة، اضغط على زر “Acquire”. إذا لم تكن مسجلاً أو مسجلاً دخولك، سيتم توجيهك تلقائياً إلى صفحة تسجيل الدخول لتسجيل حساب أو تسجيل الدخول، وبعد ذلك ستعود تلقائياً إلى الصفحة الحالية. عند التقديم لأول مرة، ستحصل على رصيد مجاني لاستخدام هذه الواجهة مجاناً.مثال على الطلب
سنأخذ مثالاً على Prompt طويل نسبياً لشرح كيفية استخدام هذه الواجهة لتحليله واختصاره.إعداد رؤوس الطلب وجسم الطلب
رؤوس الطلب (Request Headers) تشمل:accept: لتحديد استلام استجابة بصيغة JSON، هنا نكتبapplication/json.authorization: مفتاح استدعاء API، يمكن اختياره مباشرة بعد التقديم.
prompt: نص الـ Prompt المراد تحليله واختصاره، يُفضل أن يكون باللغة الإنجليزية.
مثال على الكود
CURL
Python
مثال على الاستجابة
عند نجاح الطلب، ستعيد الواجهة حتى 5 مقترحات مختصرة للـ Prompt. على سبيل المثال:prompts الذي يتضمن عدة مقترحات مختصرة، كل واحدة تحتفظ بالكلمات المفتاحية ذات الوزن الأعلى داخل Midjourney، مع إزالة الوصف المكرر أو الزائد.
معالجة الأخطاء
عند استدعاء الواجهة، إذا حدث خطأ، ستعيد الواجهة رمز الخطأ والمعلومات ذات الصلة. على سبيل المثال:400 token_mismatched: طلب غير صحيح، ربما بسبب معلمات مفقودة أو غير صحيحة.400 api_not_implemented: طلب غير صحيح، ربما بسبب معلمات مفقودة أو غير صحيحة.401 invalid_token: غير مصرح، رمز التفويض مفقود أو غير صالح.429 too_many_requests: عدد الطلبات كبير جداً، تجاوزت الحد المسموح به.500 api_error: خطأ داخلي في الخادم، حدث خطأ في الخادم.

