واجهة برمجة تطبيقات مهام Midjourney والتكامل والاستخدام

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

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

لاستخدام واجهة برمجة تطبيقات Midjourney Imagine، يجب أولاً الذهاب إلى وحدة التحكم في Ace Data Cloud للحصول على رمز API الخاص بك، للاحتفاظ به كنسخة احتياطية.

إذا لم تكن قد قمت بتسجيل الدخول أو التسجيل بعد، فسيتم تحويلك تلقائيًا إلى صفحة تسجيل الدخول لدعوتك للتسجيل وتسجيل الدخول، وبعد الانتهاء، سيتم إرجاعك تلقائيًا إلى الصفحة الحالية. يمكن استخدام رمز API واحد لاستدعاء جميع خدمات المنصة، دون الحاجة لتقديم طلب منفصل لكل خدمة. ستتلقى رصيدًا مجانيًا عند الطلب الأول، لتجربة مجانية؛ وعند نفاد الرصيد، يمكنك إعادة شحن الرصيد العام في وحدة التحكم.

📘 الوثائق الكاملة: Midjourney Imagine API →

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

يمكن استخدام واجهة برمجة تطبيقات مهام Midjourney لاستعلام نتائج واجهتي برمجة تطبيقات Midjourney Imagine وMidjourney Describe. لمزيد من المعلومات حول كيفية استخدام واجهة برمجة تطبيقات Midjourney Imagine، يرجى الرجوع إلى الوثيقة Midjourney Imagine API. ولمزيد من المعلومات حول كيفية استخدام Midjourney Describe، يرجى الرجوع إلى Midjourney Describe API. سنأخذ مثالاً على معرف المهمة الذي تم إرجاعه من خدمة واجهة برمجة تطبيقات Midjourney Imagine، لنوضح كيفية استخدام هذه الواجهة. لنفترض أن لدينا معرف مهمة: 7489df4c-ef03-4de0-b598-e9a590793434، وسنوضح كيفية تمرير معرف المهمة.

مثال على المهمة

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

رؤوس الطلب تشمل:

accept: تحديد استلام استجابة بتنسيق JSON، هنا يتم ملؤه بـ application/json.
authorization: مفتاح استدعاء الواجهة، يمكن اختياره مباشرة بعد التقديم.

جسم الطلب يشمل:

id: معرف المهمة المرفوع.
ids: مصفوفة معرفات المهام للاستعلام الجماعي.
action: طريقة تنفيذ العملية على المهمة، تدعم retrieve (استعلام فردي) وretrieve_batch (استعلام جماعي).

الإعداد كما هو موضح في الصورة أدناه:

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

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

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

CURL

curl -X POST 'https://api.acedata.cloud/midjourney/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "7489df4c-ef03-4de0-b598-e9a590793434",
  "action": "retrieve"
}'

بايثون

import requests

url = "https://api.acedata.cloud/midjourney/tasks"

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

payload = {
    "id": "7489df4c-ef03-4de0-b598-e9a590793434",
    "action": "retrieve"
}

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

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

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

{
  "_id": "668aae3f550a4144a540803b",
  "id": "7489df4c-ef03-4de0-b598-e9a590793434",
  "application_id": "9dec7b2a-1cad-41ff-8536-d4ddaf2525d4",
  "created_at": 1720364607.967,
  "started_at": 1720364608.027,
  "finished_at": 1720364637.404,
  "elapsed": 29.377,
  "credential_id": "68253cc8-505d-47f4-97ad-0050a62e4975",
  "request": {
    "mode": "fast",
    "prompt": "A cat sitting on a table",
    "action": "generate"
  },
  "type": "imagine",
  "hold": false,
  "image_id": "1259525319472185344",
  "job_id": "da317da6-f500-48e6-bf32-dd48b3e6f84f",
  "response": {
    "image_url": "https://platform.cdn.acedata.cloud/midjourney/7489df4c-ef03-4de0-b598-e9a590793434.png?imageMogr2/thumbnail/!50p",
    "image_width": 1024,
    "image_height": 1024,
    "actions": [
      "upscale1",
      "upscale2",
      "upscale3",
      "upscale4",
      "reroll",
      "variation1",
      "variation2",
      "variation3",
      "variation4"
    ],
    "raw_image_url": "https://platform.cdn.acedata.cloud/midjourney/7489df4c-ef03-4de0-b598-e9a590793434.png",
    "raw_image_width": 2048,
    "raw_image_height": 2048,
    "progress": 100,
    "image_id": "1259525319472185344",
    "task_id": "7489df4c-ef03-4de0-b598-e9a590793434",
    "success": true,
    "job_id": "da317da6-f500-48e6-bf32-dd48b3e6f84f",
    "hold": false
  }
}

تتضمن النتيجة عدة حقول، حيث يمثل حقل request جسم الطلب عند بدء المهمة، بينما يمثل حقل response جسم الاستجابة الذي تم إرجاعه بعد إكمال المهمة. إذا كان type = imagine، فإن النتيجة تتوافق مع طلب وإرجاع واجهة برمجة تطبيقات Midjourney Imagine، وإذا كان type = describe، فإن النتيجة تتوافق مع طلب وإرجاع واجهة برمجة تطبيقات Midjourney Describe. توضيح الحقول كما يلي.

id: معرف المهمة التي تم إنشاؤها لهذه الصورة، يستخدم لتحديد هذه المهمة بشكل فريد.
type: إذا كان type = imagine فهذا يعني أنه نتيجة واجهة برمجة تطبيقات Midjourney Imagine، وإذا كان type = describe فهذا يعني أنه نتيجة واجهة برمجة تطبيقات Midjourney Describe.
job_id: معرف المهمة التي تم إنشاؤها لاستعلام الصورة، يستخدم لتحديد هذه المهمة بشكل فريد.
image_id: المعرف الفريد لمهمة الصورة المستعلم عنها، يجب تمرير هذا المعامل عند الحاجة إلى إجراء عمليات تحويل على الصورة في المرة القادمة.
request: معلومات الطلب في مهمة استعلام الصورة.
response: معلومات الاستجابة في مهمة استعلام الصورة.
created_at: وقت إنشاء المهمة، طابع زمني Unix (ثوانٍ، عائم).
started_at: وقت بدء تنفيذ المهمة، طابع زمني Unix (ثوانٍ، عائم).
finished_at: وقت إكمال المهمة، طابع زمني Unix (ثوانٍ، عائم). لا يتم إرجاع هذا الحقل إذا لم تكتمل المهمة.
elapsed: الوقت المستغرق لتنفيذ المهمة، بوحدة الثواني (عائم، يحتفظ بـ 3 أرقام عشرية). لا يتم إرجاع هذا الحقل إذا لم تكتمل المهمة.

عمليات الاستعلام الجماعي

هذا مخصص لاستعلام تفاصيل مهام الصورة لعدة معرفات مهام، وما يميزها عن السابق هو أنه يجب اختيار action كـ retrieve_batch. جسم الطلب يشمل:

ids：مصفوفة معرفات المهام المرفوعة.
action：طريقة إجراء العملية على المهمة.

الإعداد كما هو موضح في الصورة أدناه:

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

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

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

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

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

{
  "items": [
    {
      "_id": "668aae3f550a4144a540803b",
      "id": "7489df4c-ef03-4de0-b598-e9a590793434",
      "application_id": "9dec7b2a-1cad-41ff-8536-d4ddaf2525d4",
      "created_at": 1720364607.967,
      "started_at": 1720364608.027,
      "finished_at": 1720364637.404,
      "elapsed": 29.377,
      "credential_id": "68253cc8-505d-47f4-97ad-0050a62e4975",
      "request": {
        "mode": "fast",
        "prompt": "A cat sitting on a table",
        "action": "generate"
      },
      "type": "imagine",
      "hold": false,
      "image_id": "1259525319472185344",
      "job_id": "da317da6-f500-48e6-bf32-dd48b3e6f84f",
      "response": {
        "image_url": "https://platform.cdn.acedata.cloud/midjourney/7489df4c-ef03-4de0-b598-e9a590793434.png?imageMogr2/thumbnail/!50p",
        "image_width": 1024,
        "image_height": 1024,
        "actions": [
          "upscale1",
          "upscale2",
          "upscale3",
          "upscale4",
          "reroll",
          "variation1",
          "variation2",
          "variation3",
          "variation4"
        ],
        "raw_image_url": "https://platform.cdn.acedata.cloud/midjourney/7489df4c-ef03-4de0-b598-e9a590793434.png",
        "raw_image_width": 2048,
        "raw_image_height": 2048,
        "progress": 100,
        "image_id": "1259525319472185344",
        "task_id": "7489df4c-ef03-4de0-b598-e9a590793434",
        "success": true,
        "job_id": "da317da6-f500-48e6-bf32-dd48b3e6f84f",
        "hold": false
      }
    },
    {
      "_id": "668b41d6550a4144a551d996",
      "id": "807f62de-c63e-4add-8345-7f0ae6dd18e7",
      "application_id": "9dec7b2a-1cad-41ff-8536-d4ddaf2525d4",
      "created_at": 1720402390.341,
      "started_at": 1720402390.401,
      "finished_at": 1720402419.813,
      "elapsed": 29.412,
      "credential_id": "6fd3e1d5-4bd6-47e8-8872-fab89a183b53",
      "request": {
        "mode": "fast",
        "prompt": "A beautiful girl",
        "action": "generate"
      },
      "type": "imagine",
      "hold": false,
      "image_id": "1259683790612070400",
      "job_id": "ede5c805-e231-498c-8f74-3aa76d5d6d12",
      "response": {
        "image_url": "https://platform.cdn.acedata.cloud/midjourney/807f62de-c63e-4add-8345-7f0ae6dd18e7.png?imageMogr2/thumbnail/!50p",
        "image_width": 1024,
        "image_height": 1024,
        "actions": [
          "upscale1",
          "upscale2",
          "upscale3",
          "upscale4",
          "reroll",
          "variation1",
          "variation2",
          "variation3",
          "variation4"
        ],
        "raw_image_url": "https://platform.cdn.acedata.cloud/midjourney/807f62de-c63e-4add-8345-7f0ae6dd18e7.png",
        "raw_image_width": 2048,
        "raw_image_height": 2048,
        "progress": 100,
        "image_id": "1259683790612070400",
        "task_id": "807f62de-c63e-4add-8345-7f0ae6dd18e7",
        "success": true,
        "job_id": "ede5c805-e231-498c-8f74-3aa76d5d6d12",
        "hold": false
      }
    }
  ],
  "count": 2
}

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

items، جميع التفاصيل المحددة لمهام الصور المجمعة. إنها مصفوفة، كل عنصر في المصفوفة له نفس تنسيق نتيجة استعلام مهمة واحدة كما هو موضح أعلاه.
count، عدد مهام الصور المجمعة في هذا الاستعلام.

CURL

curl -X POST 'https://api.acedata.cloud/midjourney/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "retrieve_batch",
  "id": "",
  "ids": ["7489df4c-ef03-4de0-b598-e9a590793434","807f62de-c63e-4add-8345-7f0ae6dd18e7"]
}'

Python

import requests

url = "https://api.acedata.cloud/midjourney/tasks"

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

payload = {
    "action": "retrieve_batch",
    "id": "",
    "ids": ["7489df4c-ef03-4de0-b598-e9a590793434","807f62de-c63e-4add-8345-7f0ae6dd18e7"]
}

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

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

عند استدعاء واجهة برمجة التطبيقات، إذا واجهت خطأ، ستقوم واجهة برمجة التطبيقات بإرجاع رمز الخطأ والمعلومات ذات الصلة. على سبيل المثال:

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 للاستعلام عن تفاصيل مهمة صورة واحدة أو مجمعة. نأمل أن تساعدك هذه الوثيقة في التوصيل والاستخدام الأفضل لهذه الواجهة. إذا كان لديك أي استفسارات، فلا تتردد في الاتصال بفريق الدعم الفني لدينا.

البداية

دردشة الذكاء الاصطناعي

صورة الذكاء الاصطناعي

فيديو الذكاء الاصطناعي

الصوت الذكي

الويب والبيانات

CAPTCHA

الهوية

وكيل

متقدم

Coding

واجهة برمجة تطبيقات مهام Midjourney والتكامل والاستخدام

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

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

مثال على المهمة

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

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

CURL

بايثون

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

عمليات الاستعلام الجماعي

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

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

CURL

Python

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

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

الخاتمة

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

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

​مثال على المهمة

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

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

​CURL

​بايثون

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

​عمليات الاستعلام الجماعي

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

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

​CURL

​Python

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

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

​الخاتمة

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

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

مثال على المهمة

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

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

CURL

بايثون

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

عمليات الاستعلام الجماعي

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

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

CURL

Python

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

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

الخاتمة