> ## Documentation Index
> Fetch the complete documentation index at: https://www.krea.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# دورة حياة المهمة
> افهم كل حالة من حالات مهمة Krea منذ الإنشاء وحتى الاكتمال، بما في ذلك أنماط الاستعلام، وإعادة المحاولة، واستراتيجيات معالجة الأخطاء العملية.
## نظرة عامة
تتّبع جميع طلبات التوليد دورة الحياة الأساسية نفسها:
### حالات المهمة
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
**مثال على تنفيذ الاستعلام:**
```javascript Node.js theme={null}
// 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;
}
```
```python Python theme={null}
import time
def wait_for_job(job_id):
while True:
response = requests.get(
f"{API_BASE}/jobs/{job_id}",
headers={"Authorization": f"Bearer {API_TOKEN}"}
)
job = response.json()
if job["status"] == "completed":
return job["result"]
if job["status"] in ("failed", "cancelled"):
raise Exception(f"Job {job['status']}: {job.get('result', {}).get('error')}")
print(f"Status: {job['status']}")
time.sleep(2)
```
## الخطوات التالية
استلم إشعارات عند اكتمال المهام
افهم حدود واجهة API حسب مستوى الخطة
استكشف جميع نقاط النهاية والمعلمات المتاحة
إنشاء مفاتيح API الخاصة بك وإدارتها