Skip to main content

​
نظرة عامة

تتّبع جميع طلبات التوليد دورة الحياة الأساسية نفسها: Job lifecycle diagram

​
حالات المهمة

queued المهمة في قائمة الانتظار للمعالجة backlogged المهمة في الانتظار بسبب حد التزامن الحالي لديك scheduled تم قبول المهمة وجدولتها للمعالجة processing تتم معالجة المهمة بواسطة عامل sampling المهمة تُنشئ عينات المخرجات intermediate-complete المهمة لديها نتيجة وسيطة وقد تستمر في المعالجة completed اكتملت المهمة بنجاح، والنتيجة متاحة في result.urls failed فشلت المهمة بسبب خطأ، والتفاصيل في result.error cancelled أُلغيت المهمة بواسطة المستخدم أو النظام

​
حالات الفشل والإلغاء

قد تفشل المهام لأسباب عدة:
  • أخطاء API من خدمة التوليد
  • معلمات غير صالحة أو تكوينات غير مدعومة
  • الرقابة على المحتوى (تصفية NSFW)
  • كشف انتهاء المهلة التلقائي (3 دقائق للأدوات المُستضافة، وساعتان لمزوّدي الخدمة الخارجيين)
لإلغاء مهمة: أرسل طلب DELETE إلى /jobs/{id}. ملاحظة: لا يمكن إلغاء المهام إلا عندما تكون في حالة queued أو processing.
مهم: لا تُحتسب رسوم على المهام الفاشلة والملغاة. أنت تدفع فقط مقابل المهام المكتملة.

​
التحقق من حالة المهمة

استعلم عن حالة المهمة باستخدام طلب GET إلى /jobs/{id}. الممارسات الموصى بها:
  • استعلم كل 2-5 ثوانٍ أثناء انتظار المهمة (backlogged أو queued أو scheduled أو processing أو sampling أو intermediate-complete)
  • استخدم التراجع الأسّي للمهام الأطول
  • توقّف عن الاستعلام عندما تكون الحالة completed أو failed أو cancelled
  • قد تتضمن بعض المهام صور معاينة في الاستجابات أثناء processing
مثال على تنفيذ الاستعلام: 
// npm install @krea-ai/sdk
import { Krea } from "@krea-ai/sdk";

const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

async function waitForJob(jobId) {
  const job = await krea.jobs.wait(jobId, { intervalMs: 2000 });
  return job.result;
}

​
الخطوات التالية

الويب هوك

استلم إشعارات عند اكتمال المهام

حدود المعدل

افهم حدود واجهة API حسب مستوى الخطة

واجهات API للنماذج

استكشف جميع نقاط النهاية والمعلمات المتاحة

مفاتيح API والفوترة

إنشاء مفاتيح API الخاصة بك وإدارتها