تكامل واستخدام Flux Tasks API

تتمثل الوظيفة الرئيسية لـ Flux Tasks API في الاستعلام عن حالة تنفيذ المهمة من خلال إدخال معرّف مهمة المنصة الذي يتم إرجاعه بواسطة Flux Images Generation API أو Flux Videos API. سيقدم هذا المستند بالتفصيل إرشادات تكامل Flux Tasks API، لمساعدتك على دمج هذه الواجهة والاستفادة الكاملة من وظائفها القوية بسهولة. من خلال Flux Tasks API، يمكنك بسهولة تنفيذ الاستعلام عن حالة تنفيذ مهام Flux Images Generation API. للحصول على مثال كامل لإرسال الفيديو والاستعلام الدوري، راجع دليل تكامل Flux Videos API. لا يتم فرض رسوم إنشاء إضافية للاستعلام عن المهام الموجودة.

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

لاستخدام Flux Images Generation API، انتقل أولاً إلى وحدة تحكم Ace Data Cloud للحصول على API Token الخاص بك، واحتفظ به للاستخدام لاحقًا.

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

📘 الوثائق الكاملة: Flux Images Generation API →

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

يمكن استخدام Flux Tasks API للاستعلام عن نتائج Flux Images Generation API. لمعرفة كيفية استخدام Flux Images Generation API، يرجى الرجوع إلى وثيقة Flux Images Generation API . سنأخذ معرّف مهمة تم إرجاعه بواسطة خدمة Flux Images Generation API كمثال، لشرح كيفية استخدام هذه الواجهة. لنفترض أن لدينا معرّف مهمة: 2db0168c-2373-4367-8d9a-9dc778802e8a، وسنوضح بعد ذلك كيفية تمرير معرّف مهمة من خلال.

صورة مثال للمهمة

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

Request Headers تتضمن:

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

Request Body يتضمن:

id: معرّف المهمة المرفوعة.
action: طريقة التشغيل على المهمة.

الإعداد كما هو موضح في الشكل التالي:

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

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

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

CURL

curl -X POST 'https://api.acedata.cloud/flux/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "2c454ff3-4f8f-47f0-8147-acb29a84d1c2",
  "action": "retrieve"
}'

Python

import requests

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

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

payload = {
    "id": "2c454ff3-4f8f-47f0-8147-acb29a84d1c2",
    "action": "retrieve"
}

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

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

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

{
  "_id": "677de81d550a4144a5f4cf62",
  "id": "2db0168c-2373-4367-8d9a-9dc778802e8a",
  "api_id": "deefc5d7-7f22-43e9-929e-f2b6afee60b7",
  "application_id": "001c2f84-2a4a-4c4d-ba3f-8a89f43b5be2",
  "created_at": 1736304669.779,
  "started_at": 1736304669.839,
  "finished_at": 1736304679.439,
  "elapsed": 9.6,
  "credential_id": "b00bddd3-140f-4343-a9a2-affb312b60de",
  "request": {
    "action": "generate",
    "size": "1024x1024",
    "prompt": "a white siamese cat"
  },
  "trace_id": "6624929c-bb80-40c0-81e8-d96af8405d19",
  "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
  "response": {
    "success": true,
    "task_id": "2db0168c-2373-4367-8d9a-9dc778802e8a",
    "trace_id": "6624929c-bb80-40c0-81e8-d96af8405d19",
    "data": [
      {
        "prompt": "a white siamese cat",
        "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
        "seed": 281520112,
        "timings": {
          "inference": 3.193
        }
      }
    ]
  }
}

تحتوي نتيجة الإرجاع على عدة حقول، وحقل request هو request body عند بدء المهمة، بينما حقل response هو response body الذي يتم إرجاعه بعد اكتمال المهمة. تعريف الحقول كما يلي.

id: معرّف مهمة إنشاء هذه الصورة، ويُستخدم لتحديد مهمة إنشاء الصورة هذه بشكل فريد.
request: معلومات الطلب في الاستعلام عن مهمة الصورة.
response: معلومات الإرجاع في الاستعلام عن مهمة الصورة.
created_at: وقت إنشاء المهمة، طابع زمني Unix (بالثواني، رقم عشري).
started_at: وقت بدء تنفيذ المهمة، طابع زمني Unix (بالثواني، رقم عشري).
finished_at: وقت اكتمال المهمة، طابع زمني Unix (بالثواني، رقم عشري). لا يتم إرجاع هذا الحقل عندما لا تكتمل المهمة.
elapsed: الوقت المستغرق في تنفيذ المهمة، بوحدة الثواني (رقم عشري، مع الاحتفاظ بـ 3 منازل عشرية). لا يتم إرجاع هذا الحقل عندما لا تكتمل المهمة.

عملية الاستعلام الدفعي

هذا للاستعلام عن تفاصيل مهام الصور لعدة معرّفات مهام، والاختلاف عن السابق هو أنه يجب تحديد action كـ retrieve_batch Request Body يتضمن:

ids: مصفوفة معرّفات المهام المرفوعة.
action: طريقة التشغيل على المهمة.

الإعداد كما هو موضح في الشكل التالي:

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

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

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

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

{
  "items": [
    {
      "_id": "677de81d550a4144a5f4cf62",
      "id": "2db0168c-2373-4367-8d9a-9dc778802e8a",
      "api_id": "deefc5d7-7f22-43e9-929e-f2b6afee60b7",
      "application_id": "001c2f84-2a4a-4c4d-ba3f-8a89f43b5be2",
      "created_at": 1736304669.779,
      "started_at": 1736304669.839,
      "finished_at": 1736304679.439,
      "elapsed": 9.6,
      "credential_id": "b00bddd3-140f-4343-a9a2-affb312b60de",
      "request": {
        "action": "generate",
        "size": "1024x1024",
        "prompt": "قط سيامي أبيض"
      },
      "trace_id": "6624929c-bb80-40c0-81e8-d96af8405d19",
      "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
      "response": {
        "success": true,
        "task_id": "2db0168c-2373-4367-8d9a-9dc778802e8a",
        "trace_id": "6624929c-bb80-40c0-81e8-d96af8405d19",
        "data": [
          {
            "prompt": "قط سيامي أبيض",
            "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
            "seed": 281520112,
            "timings": {
              "inference": 3.193
            }
          }
        ]
      }
    },
    {
      "_id": "677de950550a4144a5f52963",
      "id": "72bdd69d-290d-4710-a6d4-60c78968865a",
      "api_id": "deefc5d7-7f22-43e9-929e-f2b6afee60b7",
      "application_id": "001c2f84-2a4a-4c4d-ba3f-8a89f43b5be2",
      "created_at": 1736304976.278,
      "started_at": 1736304976.338,
      "finished_at": 1736304985.938,
      "elapsed": 9.6,
      "credential_id": "b00bddd3-140f-4343-a9a2-affb312b60de",
      "request": {
        "action": "generate",
        "size": "1024x1024",
        "prompt": "قط سيامي أبيض"
      },
      "trace_id": "1dca4b49-d31d-42e6-83d9-7f0c56f62d31",
      "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
      "response": {
        "success": true,
        "task_id": "72bdd69d-290d-4710-a6d4-60c78968865a",
        "trace_id": "1dca4b49-d31d-42e6-83d9-7f0c56f62d31",
        "data": [
          {
            "prompt": "قط سيامي أبيض",
            "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
            "seed": 1437672535,
            "timings": {
              "inference": 3.175
            }
          }
        ]
      }
    }
  ],
  "count": 2
}

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

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

CURL

curl -X POST 'https://api.acedata.cloud/flux/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["2db0168c-2373-4367-8d9a-9dc778802e8a","72bdd69d-290d-4710-a6d4-60c78968865a"],
  "action": "retrieve_batch"
}'

Python

import requests

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

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

payload = {
    "ids": ["2db0168c-2373-4367-8d9a-9dc778802e8a","72bdd69d-290d-4710-a6d4-60c78968865a"],
    "action": "retrieve_batch"
}

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

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

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

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"
}

الخلاصة

من خلال هذا المستند، أصبحت تعرف كيفية استخدام FLux Tasks API للاستعلام عن جميع معلومات التفاصيل المحددة لمهمة صورة واحدة أو مهام صور مجمّعة. نأمل أن يساعدك هذا المستند على التكامل مع واجهة API هذه واستخدامها بشكل أفضل. إذا كانت لديك أي أسئلة، فلا تتردد في الاتصال بفريق الدعم الفني لدينا.

البداية

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

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

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

الصوت الذكي

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

CAPTCHA

الهوية

Coding

المزيد من الأدلة

تكامل واستخدام Flux Tasks API

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

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

صورة مثال للمهمة

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

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

CURL

Python

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

عملية الاستعلام الدفعي

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

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

CURL

Python

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

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

الخلاصة

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

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

​صورة مثال للمهمة

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

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

​CURL

​Python

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

​عملية الاستعلام الدفعي

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

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

​CURL

​Python

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

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

​الخلاصة

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

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

صورة مثال للمهمة

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

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

CURL

Python

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

عملية الاستعلام الدفعي

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

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

CURL

Python

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

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

الخلاصة