الحالة وخطافات الويب

تتبع الأجيال غير المتزامنة

توليد الصور غير متزامن. ابدأ بـ /api/v1/generate/, ثم الاستطلاع /api/v1/generate/{generation_id}/ حتى تصل الوظيفة completed أو failed.

curl -X GET https://ulazai.com/api/v1/generate/YOUR_GENERATION_ID/ \
  -H "Authorization: Bearer YOUR_API_KEY"

حالات دورة الحياة

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

يعالج

{
  "success": true,
  "data": {
    "generation_id": "5a6be42f-4f01-4e80-9e16-8105315f0e62",
    "status": "processing",
    "estimated_time": "varies by queue",
    "prompt": "...",
    "message": "Generating your image..."
  }
}

مكتمل

{
  "success": true,
  "data": {
    "generation_id": "5a6be42f-4f01-4e80-9e16-8105315f0e62",
    "status": "completed",
    "image_url": "https://media.ulazai.com/.../image.png",
    "prompt": "...",
    "credits_used": 8
  }
}

فشل

{
  "success": true,
  "data": {
    "generation_id": "5a6be42f-4f01-4e80-9e16-8105315f0e62",
    "status": "failed",
    "error_message": "Prompt violates content policy",
    "message": "Generation failed. Credits have been refunded."
  }
}

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

تستخدم وظائف نقطة النهاية الموحدة عناوين URL لرد الاتصال الموقعة داخليًا. رد الاتصال تتم إدارة المعالجة بواسطة UlazAI ولا تتطلب الإعداد من جانب العميل.

تعرض نقاط النهاية Nano Banana القديمة أيضًا معالجة خطاف الويب على:

/nano-banana/webhook/