Skip to main content
الوظيفة الرئيسية لواجهة برمجة التطبيقات Midjourney Describe هي الحصول على وصف للصورة من خلال تحميلها. باستخدام هذه الواجهة، يكفي تمرير عنوان ملف الصورة، وستقوم الواجهة بإرجاع وصف تفصيلي للصورة. لا حاجة لإعدادات معقدة، يمكنك الحصول على وصف عالي الجودة للصورة. تدعم مجموعة متنوعة من تنسيقات الصور: سواء كانت JPEG أو PNG أو GIF أو أي تنسيقات صور شائعة أخرى، يمكن التعرف عليها ومعالجتها بسهولة. ستتناول هذه الوثيقة بالتفصيل تعليمات التكامل مع واجهة برمجة التطبيقات Midjourney Describe، لمساعدتك على دمجها بسهولة والاستفادة الكاملة من ميزاتها القوية. من خلال واجهة برمجة التطبيقات Midjourney Describe، يمكنك تحقيق أتمتة وصف الصور بسهولة، مما يزيد من كفاءة الأعمال.

عملية التقديم

لاستخدام واجهة برمجة التطبيقات Midjourney Describe، تحتاج أولاً إلى زيارة صفحة التقديم Midjourney Describe API للتقدم للحصول على الخدمة المناسبة، بعد دخول الصفحة، انقر على زر “Acquire”، كما هو موضح في الصورة: صفحة التقديم إذا لم تكن قد قمت بتسجيل الدخول أو التسجيل بعد، سيتم تحويلك تلقائيًا إلى صفحة تسجيل الدخول لدعوتك للتسجيل وتسجيل الدخول، بعد تسجيل الدخول أو التسجيل، سيتم العودة تلقائيًا إلى الصفحة الحالية. عند التقديم لأول مرة، سيكون هناك حد مجاني متاح، يمكنك استخدام هذه الواجهة مجانًا.

مثال على الطلب

سنأخذ صورة واحدة كمثال، ونوضح كيفية استخدام هذه الواجهة. لنفترض أن لدينا صورة مناظر طبيعية، وسنوضح كيفية تحميل هذه الصورة والحصول على وصف لها.

مثال على صورة الطلب

صورة المثال

إعداد رأس الطلب وجسم الطلب

Request Headers تشمل:
  • accept: تحديد استلام استجابة بتنسيق JSON، هنا يتم ملؤه بـ application/json.
  • authorization: مفتاح استدعاء الواجهة، يمكن اختياره مباشرة بعد التقديم.
Request Body تشمل:
  • image_url: عنوان ملف الصورة المحملة.
الإعداد كما هو موضح في الصورة أدناه:

مثال على الكود

يمكنك أن ترى أنه تم إنشاء كودات بلغات مختلفة تلقائيًا على الجانب الأيمن، كما هو موضح في الصورة:

بعض أمثلة الكود كما يلي:

CURL

Python

مثال على الاستجابة

بعد نجاح الطلب، ستقوم الواجهة بإرجاع 4 أوصاف للصورة. على سبيل المثال:
يمكنك أن ترى أن النتيجة تحتوي على حقل descriptions، والذي يحتوي على أربعة نتائج، كل نتيجة هي وصف محتمل.

معالجة الأخطاء

عند استدعاء الواجهة، إذا واجهت خطأ، ستقوم الواجهة بإرجاع رمز الخطأ والمعلومات ذات الصلة. على سبيل المثال:
  • 400 token_mismatched: طلب غير صحيح، ربما بسبب معلمات مفقودة أو غير صالحة.
  • 400 api_not_implemented: طلب غير صحيح، ربما بسبب معلمات مفقودة أو غير صالحة.
  • 401 invalid_token: غير مصرح، رمز تفويض غير صالح أو مفقود.
  • 429 too_many_requests: عدد كبير جدًا من الطلبات، لقد تجاوزت الحد المسموح به.
  • 500 api_error: خطأ داخلي في الخادم، حدث خطأ ما على الخادم.

مثال على استجابة الخطأ

الخاتمة

من خلال هذه الوثيقة، أصبحت على دراية بكيفية استخدام واجهة برمجة التطبيقات Midjourney Describe لوصف الصور. نأمل أن تساعدك هذه الوثيقة في التكامل والاستخدام الأفضل لهذه الواجهة. إذا كان لديك أي استفسارات، فلا تتردد في الاتصال بفريق الدعم الفني لدينا.