Skip to main content
GET
cURL
استخدم نقطة النهاية هذه بعد إنشاء صورة باستخدام POST /v1/images/generations وasync: true. يعيد طلب الإنشاء data.task_id، وتعيد نقطة النهاية هذه حالة المهمة بالإضافة إلى بيانات الصورة النهائية عند نجاح المهمة.

الاستعلام عن مهمة صورة

1

إنشاء المهمة

أرسل POST /v1/images/generations مع async: true، ثم خزّن data.task_id.
2

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

استدعِ نقطة النهاية هذه باستخدام معرّف المهمة المخزّن حتى تصبح قيمة data.status هي success أو failure.
3

قراءة بيانات الصورة

عندما تكون قيمة data.status هي success، اقرأ العنصر الأول في data.data. وبحسب model المحدد، قد يتضمن العنصر b64_json أو url أو revised_prompt.

قيم الحالة

  • pending: المهمة في قائمة الانتظار أو قيد الإنشاء.
  • success: اكتملت المهمة ويحتوي data.data على بيانات الصورة المُنشأة.
  • failure: فشلت المهمة. تحقّق من data.fail_reason عند إرجاعه.

التفويضات

Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

معلمات المسار

task_id
string
مطلوب

Task ID returned in data.task_id by the async create request.

الاستجابة

200 - application/json

Current image generation task state.

code
string
مطلوب

Request status code. Successful task lookups return success.

مثال:

"success"

data
object
مطلوب
message
string

Optional status message.