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

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

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

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

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

📘 الوثائق الكاملة: واجهة برمجة تطبيقات SeeDream Images Generation →

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

يمكن استخدام واجهة برمجة تطبيقات SeeDream Tasks لاستعلام نتائج واجهة برمجة تطبيقات SeeDream Images Generation. لمزيد من المعلومات حول كيفية استخدام واجهة برمجة تطبيقات SeeDream Images Generation، يرجى الرجوع إلى الوثائق واجهة برمجة تطبيقات SeeDream Images Generation. سنأخذ مثالاً على معرف المهمة الذي تم إرجاعه من خدمة واجهة برمجة تطبيقات SeeDream Images Generation، لنوضح كيفية استخدام هذه الواجهة. لنفترض أن لدينا معرف مهمة: 20068983-0cc9-4c6a-aeb6-9c6a3c668be0، وسنوضح كيفية تمرير معرف المهمة.

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

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

Request Headers تشمل:

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

Request Body تشمل:

id: معرف المهمة المرفوع.
action: طريقة إجراء العملية على المهمة.

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

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

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

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

CURL

curl -X POST 'https://api.acedata.cloud/seedream/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "a6e0d456-189b-4c78-9232-2fe72166ab39",
  "action": "retrieve"
}'

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

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

{
  "success": true,
  "task_id": "84d1544a-9043-4dde-a98b-e889dacd75f6",
  "trace_id": "176acf03-7ca7-4fc6-85db-e3724d4f59eb",
  "data": [
    {
      "prompt": "a white siamese cat",
      "size": "2048x2048",
      "image_url": "https://platform.cdn.acedata.cloud/seedream/6e5f9085-cc4a-4801-b77b-31550129ff19.jpg"
    }
  ]
}

تتضمن النتيجة عدة حقول، كما يلي:

success: حالة مهمة إنشاء الفيديو في ذلك الوقت.
task_id: معرف مهمة إنشاء الفيديو في ذلك الوقت.
trace_id: معرف تتبع الفيديو في ذلك الوقت.
data: قائمة نتائج مهمة إنشاء الصورة في ذلك الوقت.
- image_url: رابط مهمة إنشاء الصورة في ذلك الوقت.
- prompt: كلمة التوجيه.
- size: بكسل الصورة المولدة.

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

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

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

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

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

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

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

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

{
  "items": [
    {
      "_id": "69498b9bff2676299c5cb7a6",
      "id": "84d1544a-9043-4dde-a98b-e889dacd75f6",
      "api_id": "86ad30f3-0bc8-4b9b-b019-b9fa5b05672e",
      "application_id": "11e25072-de6d-4bd6-81e7-77ee0055499a",
      "created_at": 1766427547.107,
      "started_at": 1766427547.167,
      "finished_at": 1766427560.667,
      "elapsed": 13.5,
      "credential_id": "50892af9-597f-426e-a455-bc1739de95b0",
      "request": {
        "action": "generate",
        "model": "doubao-seedream-4-0-250828",
        "prompt": "قط سيامي أبيض"
      },
      "trace_id": "176acf03-7ca7-4fc6-85db-e3724d4f59eb",
      "type": "images",
      "user_id": "b60a9491-1eba-4ab8-a93f-12c0fd81dab4",
      "response": {
        "success": true,
        "task_id": "84d1544a-9043-4dde-a98b-e889dacd75f6",
        "trace_id": "176acf03-7ca7-4fc6-85db-e3724d4f59eb",
        "data": [
          {
            "prompt": "قط سيامي أبيض",
            "size": "2048x2048",
            "image_url": "https://platform.cdn.acedata.cloud/seedream/6e5f9085-cc4a-4801-b77b-31550129ff19.jpg"
          }
        ]
      }
    },
    {
      "_id": "69498b9bff2676299c5cb7a6",
      "id": "84d1544a-9043-4dde-a98b-e889dacd75f6",
      "api_id": "86ad30f3-0bc8-4b9b-b019-b9fa5b05672e",
      "application_id": "11e25072-de6d-4bd6-81e7-77ee0055499a",
      "created_at": 1766427547.107,
      "started_at": 1766427547.167,
      "finished_at": 1766427560.667,
      "elapsed": 13.5,
      "credential_id": "50892af9-597f-426e-a455-bc1739de95b0",
      "request": {
        "action": "generate",
        "model": "doubao-seedream-4-0-250828",
        "prompt": "قط سيامي أبيض"
      },
      "trace_id": "176acf03-7ca7-4fc6-85db-e3724d4f59eb",
      "type": "images",
      "user_id": "b60a9491-1eba-4ab8-a93f-12c0fd81dab4",
      "response": {
        "success": true,
        "task_id": "84d1544a-9043-4dde-a98b-e889dacd75f6",
        "trace_id": "176acf03-7ca7-4fc6-85db-e3724d4f59eb",
        "data": [
          {
            "prompt": "قط سيامي أبيض",
            "size": "2048x2048",
            "image_url": "https://platform.cdn.acedata.cloud/seedream/6e5f9085-cc4a-4801-b77b-31550129ff19.jpg"
          }
        ]
      }
    }
  ],
  "count": 2
}

返回结果一共有多个字段，其中items是包含了批量任务的具体详情信息，每个任务的具体信息与上文的字段一样，字段信息如下。

items，批量任务的所有具体详情信息。它是一个数组，每个数组的元素和上文查询单个任务的返回结果格式是一样的。
count，此处批量查询任务的个数。

批量结果里每个任务对象还带有以下计时字段。

created_at，任务创建时间，Unix 时间戳（秒，浮点）。
started_at，任务开始执行时间，Unix 时间戳（秒，浮点）。
finished_at，任务完成时间，Unix 时间戳（秒，浮点）。任务未完成时不返回该字段。
elapsed，任务执行耗时，单位为秒（浮点，保留 3 位小数）。任务未完成时不返回该字段。

CURL

curl -X POST 'https://api.acedata.cloud/seedance/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["84d1544a-9043-4dde-a98b-e889dacd75f6","84d1544a-9043-4dde-a98b-e889dacd75f6"],
  "action": "retrieve_batch"
}'

错误处理

在调用 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": "فشل في جلب البيانات"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

结论

من خلال هذه الوثيقة، لقد فهمت كيفية استخدام واجهة برمجة تطبيقات SeeDream Tasks للاستعلام عن تفاصيل جميع المهام الفردية أو الدفعات. نأمل أن تساعدك هذه الوثيقة في التوصيل واستخدام واجهة برمجة التطبيقات بشكل أفضل. إذا كان لديك أي أسئلة، فلا تتردد في الاتصال بفريق الدعم الفني لدينا.

البداية

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

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

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

الصوت الذكي

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

CAPTCHA

الهوية

وكيل

متقدم

Coding

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

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

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

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

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

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

CURL

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

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

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

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

CURL

错误处理

错误响应示例

结论

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

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

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

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

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

​CURL

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

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

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

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

​CURL

​错误处理

​错误响应示例

​结论

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

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

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

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

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

CURL

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

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

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

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

CURL

错误处理

错误响应示例

结论