VberAI API — مرجع RESTful للمطوّرين

واجهة VberAI API هي واجهة HTTP بنمط RESTful لتضمين قدرات الذكاء الاصطناعي من VberAI (اليوم: القص الفائق بالذكاء الاصطناعي) في تطبيقاتك وألعابك وخطوط الأتمتة لديك. تعتمد المصادقة على مفاتيح API مع طلبات موقّعة؛ ورموز الأخطاء الشائعة موحّدة؛ وتُدفع الفوترة لكل طلب بأرصدة VberAI.

API v1
مستقر

توثيق API

أنشئ الصور، وأزل الخلفيات، وشغّل خطوط معالجة الذكاء الاصطناعي في VberAI مباشرةً عبر HTTP — باستخدام مفاتيح API الشخصية أو المؤسسية.

فصل الطبقات بالذكاء الاصطناعي

أدخِل صورة واجهة مسطّحة لتحصل على طبقات قابلة للتحرير: صورة خلفية PNG، وملف PNG شفاف لكل عنصر، وقائمة JSON تذكر اسم كل طبقة ونوعها وموضعها وحجمها وترتيب تراكبها.

يقسّم صورة ثابتة واحدة إلى عناصر مشهد متعدّدة الطبقات قابلة للتحرير، مع إبقاء النص قابلًا للتحرير. مُعدّ لتقسيم مشاهد الواجهة تلقائيًا وإعادة بناء التصاميم.

آلية العمل

  1. 1أرسل اللقطة المسطّحة لتحصل فورًا على taskId — تعمل المهمة بشكل غير متزامن وتستغرق عادةً دقيقتين إلى ثلاث.
  2. 2استعلم عن حالة المهمة، أو دع الـ webhook يخطرك عند الانتهاء.
  3. 3نزّل ملفات PNG من الروابط الموقّعة واقرأ result.text للحصول على قائمة الطبقات.

نقاط النهاية

الإجراءالمفتاح الشخصيالمفتاح المؤسسي
الإرسالPOST /ai/tasksPOST /ai/org-services/ai-layer-split/execute-async
استطلاع حالة المهمةGET /ai/tasks/{taskId}GET /ai/org-services/tasks/{taskId}
إعادة توقيع روابط تنزيل جديدةGET /ai/tasks/{taskId}/outputsGET /ai/org-services/tasks/{taskId}/outputs

يجب على المفاتيح المؤسسية استطلاع مسار /ai/org-services

مفتاح مؤسسي (vber_org_sk_) يُرسل إلى مسار شخصي /ai/tasks يعيد 401 INVALID_API_KEY — إذ تقبل المسارات الشخصية المفاتيح الشخصية فقط. استطلع دائمًا المهام المؤسسية على /ai/org-services/tasks/{taskId}. أما cancel و batch-status فمتاحان للمفتاح الشخصي فقط.

غلاف الطلب

معاملات الخدمة متطابقة لنوعَي المفتاح؛ الاختلاف في الغلاف المحيط بها فقط.

الحقلالمفتاح الشخصيالمفتاح المؤسسي
معاملات الخدمة المذكورة أدناه.serviceCode + inputsinput
webhookUrlاختيارياختياري
webhookSecretاختيارياختياري

المفتاح الشخصي

يمكن لكلا نوعَي المفاتيح الاكتفاء بالاستعلام: اترك webhookUrl فارغًا وتحقّق من المهمة بنفسك، أو حدّده لتصلك المناداة عند الانتهاء. وعند تحديده يجب أن يكون رابط https عامًا.

معاملات الخدمة

المعاملالنوعمطلوبالوصف
messagesarrayأحدهمامصفوفة المحادثة التي تحمل الصورة المصدر: يجب أن يتضمّن content[] جزءًا بالشكل { "type": "image_url", "image_url": { "url": "…" } }. ويمكن أن يكون الرابط https عامًا أو data: URI مضمّنًا.
referenceImagestringأحدهماصيغة مختصرة للصورة المصدر: رابط https عام أو data: URI مضمّن. استخدمه بدلًا من messages[].
referenceWidthnumberلاالعرض المعلن للصورة المصدر بالبكسل. يُستخدم فقط لتحديد شريحة السعر عند الإرسال؛ أما الحجم الفعلي فيُقاس من الصورة نفسها.
referenceHeightnumberلاالارتفاع المعلن للصورة المصدر بالبكسل. الغرض نفسه المذكور في referenceWidth.
imageConfigobjectلامحجوز لخيارات توليد مستقبلية، ويُتجاهل حاليًا.
قدّم الصورة المصدر إما عبر messages[] (أجزاء محتوى بأسلوب OpenAI) أو عبر referenceImage — أحدهما مطلوب.

صور base64 المضمّنة

بدلًا من استضافة اللقطة بنفسك، يمكنك وضعها مباشرة في الطلب على شكل data: URI. تخزّنها المنصّة على الخادم وتمرّر الرابط الناتج إلى خط المعالجة، دون أي تغيير آخر.

json
{
  "referenceImage": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
  "referenceWidth": 1295,
  "referenceHeight": 726
}
الوسائط المضمّنة محدودة بـ 20 ميغابايت لكل عنصر (الحجم بعد فك الترميز وليس طول نص base64). أما المصادر الأكبر فمرّرها عبر رابط https.
POST/ai/tasks
bash
curl -X POST https://api.vberai.com/api/ai/tasks \
  -H "X-API-Key: vber_sk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "serviceCode": "ai-layer-split",
  "inputs": {
    "messages": [
      {
        "role": "user",
        "content": [
          { "type": "image_url", "image_url": { "url": "https://example.com/lobby.png" } }
        ]
      }
    ],
    "referenceWidth": 1295,
    "referenceHeight": 726
  },
  "webhookUrl": "https://your-server.com/hook",
  "webhookSecret": "whsec_your_secret"
}'

استجابة الإرسال — HTTP 201

json
{
  "success": true,
  "message": "Created",
  "data": {
    "taskId": "6a9db1471ef5f25400621411",
    "taskToken": "510932d23b39a0176837a3adfd6f64a773bc85f984417a7d6bcde08108494d30",
    "status": "queued",
    "estimatedCredits": 150,
    "message": "Task queued for processing"
  },
  "timestamp": "2026-09-06T18:30:31.837Z"
}

الاستعلام عن المهمة

استعلم حتى تصبح status بالقيمة completed أو failed. يبقى سجل المهمة وملفاتها متاحة سبعة أيام.

تمر المهمة عبر هذه القيم. توقف عن الاستطلاع بمجرد وصولك إلى حالة نهائية: completed أو failed أو cancelled أو timeout.

queuedprocessingcompletedfailedcancelledtimeout

حقول المهمة

الحقلالوصف
taskIdمعرّف المهمة، ويُستخدم للاستعلام وجلب المخرجات ومطابقة الـ webhook.
serviceCodeدائمًا ai-layer-split.
statusqueued · processing · completed · failed · cancelled · timeout.
progressتقدّم تقريبي عندما تبلّغ عنه الواجهة الخلفية، وإلا فالقيمة null.
providerقناة التنفيذ، ويُبلَّغ عنها دائمًا بالقيمة external.
hasResultتصبح true بمجرد جاهزية result.
errorسبب الإخفاق؛ وتكون null ما دامت المهمة سليمة.
createdAt · startedAt · completedAtأوقات الإنشاء وبدء التنفيذ والاكتمال (ISO 8601، بتوقيت UTC).
expiresAtموعد حذف السجل والملفات: بعد سبعة أيام من الاكتمال.
creditsEstimated · creditsActualالرصيد المحجوز عند الإرسال والمخصوم فعليًا عند الاكتمال. يتطابقان عند النجاح، ويُسترد كامل الرصيد عند الإخفاق.
outputCountعدد الملفات المُعادة.
resultكائن النتيجة الموصوف أدناه، ويظهر بعد اكتمال المهمة.

جلب النتيجة

تعيد نقطة نهاية المخرجات الكائن result نفسه مع روابط تنزيل موقّعة حديثًا — استدعها مجددًا كلما انتهت صلاحية رابط.

json
{
  "success": true,
  "data": {
    "taskId": "6a9db1431ef5f254006213e0",
    "status": "completed",
    "result": { "type": "images", "assets": [ … ], "text": "{ … }" },
    "completedAt": "2026-09-06T18:32:26.326Z"
  }
}

Webhooks

عند ضبط webhookUrl ترسل المنصّة عبر POST المحتوى نفسه الذي كان الاستعلام سيعيده. وبضبط webhookSecret تحصل على ترويسة توقيع يمكنك التحقق منها.

إذا عيّنت webhookSecret، يتضمن كل تسليم ترويسة X-Webhook-Signature — وهي HMAC-SHA256 لحمولة JSON الخام، مُرمّزة بالنظام السداسي عشري. أعد حسابها باستخدام سرّك وقارنها قبل الوثوق بالحمولة. تحمل عمليات التسليم أيضًا X-Idempotency-Key (taskId + status) لتتمكن من تجاهل التكرارات.

حمولة الـ webhook

json
{
  "taskId": "6a9db1431ef5f254006213e0",
  "serviceCode": "ai-layer-split",
  "status": "completed",
  "timestamp": "2026-09-06T18:32:26.401Z",
  "result": {
    "type": "images",
    "assets": [ { "index": 0, "name": "Lbg", "url": "https://assets.vberai.org/…/0.png?<signed-query>", "mimeType": "image/png", "size": 5067542, "sha256": "7ceb4dad…" }, … ],
    "text": "{\"imageSize\":{\"width\":1295,\"height\":726},\"nodes\":[…]}"
  }
}

Webhook · مهمة فاشلة

json
{
  "taskId": "6a9db1431ef5f254006213e0",
  "serviceCode": "ai-layer-split",
  "status": "failed",
  "timestamp": "2026-09-06T18:32:26.401Z",
  "error": { "code": "EXECUTION_ERROR", "message": "Task processing failed" }
}

حالة المهمة

GET/ai/tasks/{taskId}
bash
curl https://api.vberai.com/api/ai/tasks/{taskId} \
  -H "X-API-Key: vber_sk_YOUR_KEY"

جلب المخرجات

GET/ai/tasks/{taskId}/outputs
bash
curl https://api.vberai.com/api/ai/tasks/{taskId}/outputs \
  -H "X-API-Key: vber_sk_YOUR_KEY"

كائن result

يتكوّن result من جزأين: صور الطبقات في assets[]، وقائمة الطبقات كنص JSON في text. وتطابق قيمة assets[].name معرّف طبقتها واحدًا لواحد.

الملفات الناتجة

الحقلالنوعالوصف
indexnumberالموضع داخل مصفوفة assets.
namestringمعرّف الطبقة، وهو مطابق لمعرّف العقدة المقابلة في الشجرة — وبه تُربط الصورة بموقعها.
urlstringرابط تنزيل موقّع. استخدمه كما هو دون حذف سلسلة الاستعلام.
mimeType"image/png"دائمًا image/png مع قناة ألفا.
sizenumberحجم الملف بالبايت.
sha256stringبصمة SHA-256 للملف، للتحقق من السلامة ومنع التكرار.
s3Keystringمفتاح الكائن الداخلي، للاطلاع فقط.
روابط التنزيل قصيرة الأجل (نحو ساعة). استدعِ نقطة نهاية المخرجات مجددًا للحصول على روابط جديدة؛ أما الملفات نفسها فتبقى سبعة أيام.

تسمية الطبقات

يمنح الخادم المعرّفات وتبقى ثابتة داخل المهمة الواحدة، والبادئة تدل على نوع الطبقة.

القيمةالمعنى
Lbgصورة الخلفية PNG: الصورة كاملة بعد إزالة كل العناصر المكتشفة وإعادة رسم الفراغات. واحدة لكل مهمة وهي الطبقة السفلى. وقد تأتي أكبر من imageSize، فحجّمها وفق المقاس الذي تعمل به.
A001, A002, …ملف PNG لكل عنصر صورة، مرقّم بترتيب القائمة. خلفية شفافة، والأجزاء التي كانت محجوبة خلف عناصر أخرى مستكملة. وحجمه بالبكسل يساوي box × imageSize.
T001, T002, …عناصر النص. لا صورة لها عن قصد: تحصل بدلًا من ذلك على الأحرف الدقيقة وتنسيقها لتعيد إنشاءها كنص حقيقي.
groupمدخلات المجموعات. بلا ملفات PNG؛ فهي تبيّن فقط الطبقات التي تنتمي معًا.

مهمة مكتملة

json
{
  "success": true,
  "data": {
    "taskId": "6a9db1431ef5f254006213e0",
    "serviceCode": "ai-layer-split",
    "status": "completed",
    "progress": null,
    "provider": "external",
    "hasResult": true,
    "error": null,
    "createdAt": "2026-09-06T18:30:27.398Z",
    "startedAt": "2026-09-06T18:30:29.012Z",
    "completedAt": "2026-09-06T18:32:26.326Z",
    "expiresAt": "2026-09-13T18:32:26.326Z",
    "creditsEstimated": 150,
    "creditsActual": 150,
    "outputCount": 23,
    "result": {
      "type": "images",
      "assets": [
        {
          "index": 0,
          "url": "https://assets.vberai.org/tmp/user-assets/6a76f458…/task_6a9db143…_background/0.png?<signed-query>",
          "mimeType": "image/png",
          "s3Key": "tmp/user-assets/6a76f458…/task_6a9db143…_background/0.png",
          "size": 5067542,
          "sha256": "7ceb4dad585d2c60368e35c994ea53819b45f29f84fa5ec36704e9b3794a5f5e",
          "name": "Lbg"
        },
        {
          "index": 1,
          "url": "https://assets.vberai.org/ai-deliveries/6a76f458…/task_6a9db143…/A001-ab405a4a….png?<signed-query>",
          "mimeType": "image/png",
          "s3Key": "ai-deliveries/6a76f458…/task_6a9db143…/A001-ab405a4a….png",
          "size": 73117,
          "sha256": "ab405a4a607a7c9e95bd5dba0150f84743c73362f482bbeb990fc4687c90055e",
          "name": "A001"
        },
        … 21 more "A002" … "A022" assets …
      ],
      "text": "{\"imageSize\":{\"width\":1295,\"height\":726},\"nodes\":[{\"id\":\"Lbg\",…},{\"id\":\"A001\",…},…]}"
    }
  }
}

قائمة الطبقات (result.text)

القيمة result.text نص JSON — حلّلها. وهي تسرد كل طبقة مع اسمها ونوعها وموضعها وحجمها ومجموعتها وترتيب تراكبها.

المستوى الأعلى

الحقلالنوعالوصف
imageSize{ width, height }أبعاد الصورة المحلَّلة بالبكسل. كل box نسبة منها — اضربه فيها (أو في أي مقاس تريده) للحصول على البكسل.
nodesLayerNode[]جميع الطبقات في مصفوفة مسطّحة. يأتي التجميع من parentId والتراكب من paintOrder؛ أما ترتيب المصفوفة نفسه فلا معنى له.

مدخل الطبقة

الحقلالنوعالوصف
idstringمعرّف الطبقة، وهو مطابق لقيمة assets[].name المقابلة (Lbg وA001 وT001 …). استخدمه لربط الطبقة بملف PNG الخاص بها.
namestringاسم مقروء يستنتجه الذكاء الاصطناعي، مثل join_room_card. وصفي لكنه ليس فريدًا بالضرورة — استخدم id مفتاحًا و name للعرض.
kindstringنوع الطبقة؛ راجع الجدول أدناه.
box[x, y, w, h]الموضع والحجم بالشكل [x, y, العرض, الارتفاع] كنِسَب من imageSize ونقطة الأصل أعلى اليسار. اضرب في imageSize للحصول على البكسل.
parentIdstring | nullمعرّف المجموعة الحاوية، أو null في المستوى الجذري.
paintOrdernumberترتيب التراكب بين الطبقات ذات الأب نفسه، تصاعديًا من الخلف إلى الأمام. والخلفية تساوي -1.
occludedbooleanتكون true عندما يكون جزء من هذا العنصر محجوبًا خلف عنصر آخر واحتاج إلى إعادة بناء.
instances[x, y, w, h][]مواضع إضافية للعنصر المتكرر نفسه. ضع ملف PNG ذاته في كل إطار منها بدل طلب صور إضافية.
textobjectتنسيق النص؛ ولا يظهر إلا عندما تكون kind بالقيمة text.

أنواع الطبقات

القيمةالمعنى
backgroundالخلفية المرمّمة. واحدة فقط وتُرسم أولًا.
groupحاوية للتداخل، وليست لها صورة خاصة.
uiلوحة أو بطاقة أو زر أو أي سطح واجهة آخر. ويرافقها ملف PNG.
iconأيقونة صغيرة، ويرافقها ملف PNG وتُعامل مثل ui.
textنص برمجي. لا يوجد PNG — أعد إنشاءه كنص قابل للتحرير.

خصائص النص

الحقلالنوعالوصف
textstringالأحرف المقروءة من اللقطة بلغتها الأصلية.
fontSizePctnumberارتفاع الحرف كنسبة من imageSize.height. اضربه في الارتفاع الذي تعمل به للحصول على حجم الخط بالبكسل.
color"#RRGGBB"لون تعبئة الحرف.
fontWeight100–900سماكة الخط كقيمة رقمية.
italicbooleanما إذا كان النص مائلًا.
align"LEFT" | "CENTER" | "RIGHT"المحاذاة الأفقية داخل الإطار.
fontFamilystringعائلة الخط المقترحة؛ استخدم خطك الافتراضي إن لم تكن متاحة.
strokeColor"#RRGGBB"لون حدود الحرف عندما يكون للنص حد خارجي.
strokeWidthPctnumberسماكة الحد كنسبة من imageSize.height.
shadow{ color, dxPct, dyPct, blurPct }الظل: اللون مع الإزاحة ودرجة التمويه كنِسَب من عرض imageSize وارتفاعها.

قائمة الطبقات (مقتطف)

json
{
  "imageSize": { "width": 1295, "height": 726 },
  "nodes": [
    { "id": "Lbg",  "name": "background",     "kind": "background", "box": [0, 0, 1, 1], "parentId": null, "paintOrder": -1, "occluded": false },
    { "id": "A001", "name": "player_info_bg", "kind": "ui", "box": [0.0026, 0, 0.2644, 0.1322], "parentId": null, "paintOrder": 1, "occluded": false },
    { "id": "A005", "name": "player_avatar",  "kind": "ui", "box": [0.0108, 0.0069, 0.068, 0.1157], "parentId": null, "paintOrder": 5, "occluded": false },
    { "id": "A013", "name": "join_room_card", "kind": "ui", "box": [0.3153, 0.2546, 0.1825, 0.6906], "parentId": null, "paintOrder": 13, "occluded": false },
    {
      "id": "T001", "name": "player_name", "kind": "text",
      "box": [0.0827, 0.0193, 0.1543, 0.0427], "parentId": null, "paintOrder": 18, "occluded": false,
      "text": { "text": "明月清风晓星尘", "fontSizePct": 0.022, "color": "#FFFFFF", "fontWeight": 400, "align": "LEFT" }
    },
    {
      "id": "T003", "name": "currency_1_amount", "kind": "text",
      "box": [0.3614, 0.0372, 0.0533, 0.0455], "parentId": null, "paintOrder": 20, "occluded": false,
      "text": {
        "text": "87万", "fontSizePct": 0.0248, "color": "#FFFFFF", "fontWeight": 700, "align": "CENTER",
        "strokeColor": "#5C3A21", "strokeWidthPct": 0.0028
      }
    },
    … 23 more nodes …
  ]
}

البنية

javascript
// JSON.parse(result.text)
{
  imageSize: { width, height },      // px of the analysed image
  nodes: [
    {
      id: "Lbg" | "A001" | "T001" | "<group id>",   // == asset name
      name: "join_room_card",                        // AI-given, may repeat
      kind: "background" | "group" | "ui" | "icon" | "text",
      box: [x, y, w, h],               // fractions 0..1 of imageSize
      parentId: null | "<group id>",
      paintOrder: -1 | 0 | 1 | ...,    // ascending = bottom → top (siblings)
      occluded: false,
      instances: [[x, y, w, h]],       // optional: repeated placements
      text: {                          // only when kind === "text"
        text, fontSizePct, color, fontWeight, italic, align,
        fontFamily, strokeColor, strokeWidthPct,
        shadow: { color, dxPct, dyPct, blurPct }
      }
    }
  ]
}

استخدام الطبقات

المواضع والأحجام نِسَب، لذا تصلح القائمة نفسها لأي مقاس بالبكسل.

  1. 1اختر المقاس بالبكسل الذي ستعمل به — فـ imageSize هو مقاس التحليل، وكل box نسبة منه.
  2. 2ضع Lbg في الأسفل بحيث يغطي المساحة كاملة.
  3. 3رتّب البقية: جمّعها حسب parentId ثم رتّبها تصاعديًا حسب paintOrder (من الخلف إلى الأمام).
  4. 4ضع ملف PNG لكل عنصر ui وicon عند إطاره، وكرّر ذلك عند كل موضع في instances؛ أما طبقات النص فاستخدم لها الأحرف والتنسيق من text.
قد يأتي Lbg أكبر من imageSize — فحجّمه بدل افتراض تطابق المقاسين.
يأتي النص أحرفًا وتنسيقًا لا صورة، فيبقى قابلًا للتحرير والترجمة وواضحًا عند أي مقاس.

إنشاء قائمة التوضيع

javascript
const { result } = task;            // from polling, outputs or the webhook
const tree = JSON.parse(result.text);
const { width: W, height: H } = tree.imageSize;    // reference pixel size
const png = Object.fromEntries(result.assets.map((a) => [a.name, a.url]));

// 1) box fractions -> pixels, at whatever size you work at
const px = ([x, y, w, h]) => ({ x: x * W, y: y * H, width: w * W, height: h * H });

// 2) back -> front within each parent
const childrenOf = (parentId) =>
  tree.nodes
    .filter((n) => n.parentId === parentId)
    .sort((a, b) => a.paintOrder - b.paintOrder);

// 3) flatten into a placement list your app can consume
function collect(parentId = null, out = []) {
  for (const n of childrenOf(parentId)) {
    if (n.kind === "group") { collect(n.id, out); continue; }
    for (const box of [n.box, ...(n.instances ?? [])]) {
      out.push({
        id: n.id,
        name: n.name,                              // e.g. "join_room_card"
        kind: n.kind,                              // background | ui | icon | text
        ...px(box),                                // x, y, width, height in px
        order: n.paintOrder,
        image: n.kind === "text" ? null : png[n.id],
        text: n.text ?? null,                      // content + styling, text only
      });
    }
  }
  return out;
}

const layers = collect();                          // ready to place or import

التسعير

شريحة الدقة

سعر ثابت لكل استدعاء يُحدَّد حسب الضلع الأطول للصورة المصدر. تُعاد القيمة في estimatedCredits عند الإرسال وتُخصم عند الاكتمال، ويُسترد كامل المبلغ عند إخفاق المهمة.

الشريحةالضلع الأطولالرصيد
1K≤ 1024 px120
2K≤ 2048 px180
4K> 2048 px250
أسعار الشرائح قابلة للتعديل، لذا اعتمد قيمة estimatedCredits في استجابة الإرسال كمبلغ نهائي لذلك الاستدعاء.

الحدود

القيمةالوصف
2048 pxتُصغَّر الصور المصدر إلى 2048 بكسل للضلع الأطول قبل التحليل.
300يُكتشف 300 عنصر كحد أقصى لكل صورة.
20 MBالوسائط المضمّنة بصيغة base64 محدودة بـ 20 ميغابايت لكل عنصر.
2–3 دقائقالمدة المعتادة من البداية إلى النهاية.
7 أياممدة الاحتفاظ بسجل المهمة وملفاتها.
نحو ساعةصلاحية رابط التنزيل الموقّع.

الأخطاء

تُعاد أخطاء الإرسال بشكل متزامن، أما أخطاء التنفيذ فتظهر كمهمة بحالة failed مصحوبة بكائن error.

الحالةالرمزالمعنى
400—طلب غير صالح — وغالبًا لم تُقدَّم صورة مصدر لا في messages[] ولا في referenceImage.
401INVALID_API_KEY · INVALID_ORG_API_KEYمفتاح الواجهة مفقود أو غير صالح.
402INSUFFICIENT_CREDITS · INSUFFICIENT_ORG_CREDITSالرصيد لا يكفي لشريحة دقة هذه الصورة.
403API_SERVICE_NOT_ALLOWED · ORG_DISABLEDالمفتاح أو المؤسسة غير مصرَّح لها باستدعاء هذه الخدمة.
413—صورة base64 المضمّنة تتجاوز حد 20 ميغابايت — مرّرها عبر رابط https بدلًا من ذلك.
429RATE_LIMIT_MINUTE · RATE_LIMIT_DAY · CONCURRENCY_LIMIT_EXCEEDEDبلغت حد المعدل أو التزامن؛ أعد المحاولة بعد انتظار قصير.
failederror.codeأخفق التنفيذ بعد بدء المهمة. ويوضّح كل من error.code وerror.message السبب، ويُسترد الرصيد المحجوز بالكامل.

استجابة الخطأ — HTTP 400

json
{
  "success": false,
  "message": "A reference image is required: provide it as an `image_url` part inside messages[].content[], or pass `referenceImage` directly.",
  "timestamp": "2026-09-06T18:30:27.398Z"
}

مهمة فاشلة (عبر الاستعلام)

json
{
  "success": true,
  "data": {
    "taskId": "6a9db1431ef5f254006213e0",
    "serviceCode": "ai-layer-split",
    "status": "failed",
    "hasResult": false,
    "error": { "code": "EXECUTION_ERROR", "message": "Task processing failed" },
    "creditsEstimated": 150,
    "creditsActual": 0,
    "outputCount": 0
  }
}