الانتقال إلى المحتوى الرئيسي

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.

الوظيفة الرئيسية لواجهة برمجة التطبيقات Midjourney Shorten API هي الاتصال بأمر /shorten الرسمي من Midjourney (تحليل Prompt)، لتحليل جزء من الـ Prompt، والتعرف على الكلمات المفتاحية ذات الوزن الأعلى، وإنشاء 5 مقترحات مختصرة أكثر للـ Prompt. هذه الواجهة مناسبة جداً لـ:
  • تقليل طول الـ Prompt الطويل قبل استدعاء imagine لزيادة دقة الصور الناتجة؛
  • فهم وزن كل رمز (token) في Midjourney بشكل عكسي من خلال المقترحات، مما يسهل هندسة الـ Prompt؛
  • دمجها مع خطوط العمل الآلية لتجميع الكلمات المفتاحية وتقليل طول الـ Prompt الذي يدخله المستخدم.
ستشرح هذه الوثيقة بالتفصيل كيفية التكامل مع Midjourney Shorten API لمساعدتك على دمج هذه الواجهة بسهولة.

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

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

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

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

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

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

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

CURL

curl -X POST 'https://api.xhuoapi.ai/v1/midjourney/shorten' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "prompt": "a serene mountain lake at sunrise, mist rising from the water, towering pine trees on the shore, golden hour lighting, ultra detailed, cinematic, 35mm film photography style, masterpiece --ar 16:9 --v 6"
}'

Python

import requests

url = "https://api.xhuoapi.ai/v1/midjourney/shorten"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json",
}

payload = {
    "prompt": (
        "a serene mountain lake at sunrise, mist rising from the water, "
        "towering pine trees on the shore, golden hour lighting, ultra "
        "detailed, cinematic, 35mm film photography style, masterpiece "
        "--ar 16:9 --v 6"
    )
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

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

عند نجاح الطلب، ستعيد الواجهة حتى 5 مقترحات مختصرة للـ Prompt. على سبيل المثال:
{
  "prompts": [
    "a serene mountain lake at sunrise, mist rising from the water, golden hour lighting --ar 16:9",
    "mountain lake sunrise with mist, golden light --ar 16:9 --v 6",
    "tranquil alpine lake, dawn mist, warm golden tones, cinematic --ar 16:9",
    "sunrise over a misty mountain lake, rich golden hour photography --ar 16:9 --style raw",
    "misty lake at dawn, mountains in background, golden sunrise --ar 16:9"
  ]
}
يمكن ملاحظة أن النتيجة تحتوي على حقل prompts الذي يتضمن عدة مقترحات مختصرة، كل واحدة تحتفظ بالكلمات المفتاحية ذات الوزن الأعلى داخل Midjourney، مع إزالة الوصف المكرر أو الزائد.

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

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

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

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

الخلاصة

من خلال هذه الوثيقة، أصبحت تعرف كيفية استخدام Midjourney Shorten API لتحليل واختصار الـ Prompt. يُنصح بدمج هذه الواجهة مع Midjourney Imagine API: استخدم أولاً Shorten API للحصول على عدة مقترحات مختصرة، ثم اختر الأنسب منها لتمريره إلى Imagine API لإنشاء الصورة. إذا كان لديك أي استفسار، لا تتردد في التواصل مع فريق الدعم الفني لدينا.