الانتقال إلى المحتوى الرئيسي
GET
/
replicate
/
v1
/
predictions
/
{id}
Query a Replicate prediction
curl --request GET \
  --url https://api.cometapi.com/replicate/v1/predictions/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "input": {},
  "model": "<string>",
  "output": [
    "<string>"
  ],
  "status": "<string>",
  "created_at": "<string>",
  "data_removed": true,
  "logs": "<string>",
  "urls": {
    "get": "<string>",
    "cancel": "<string>",
    "stream": "<string>"
  },
  "error": "<string>",
  "metrics": {
    "image_count": 123,
    "predict_time": 123
  },
  "version": "<string>",
  "started_at": "<string>",
  "completed_at": "<string>"
}
استخدم نقطة النهاية هذه بعد أن يكون لديك بالفعل معرّف prediction في Replicate. فهي تعرض الحالة الحالية للمهمة وتعيد روابط output عند اكتمال prediction.

تحقّق من هذه الحقول أولاً

  • status لمعرفة ما إذا كان prediction لا يزال قيد التشغيل أو انتهى بالفعل
  • output للحصول على روابط الأصول التي تم توليدها
  • error لمعرفة الإخفاقات من جهة المزوّد
  • metrics عندما تحتاج إلى توقيت التنفيذ أو تفاصيل عدد الصور

نمط Polling

1

أنشئ prediction أولاً

2

استعلم بشكل متكرر باستخدام معرّف prediction

استمر في الاستعلام حتى تصبح status نهائية ويكون output قد امتلأ أو تتم إعادة خطأ من المزوّد.
3

احفظ الأصول المكتملة

تعامل مع روابط الأصول المعادة باعتبارها روابط تسليم، وانقلها إلى مساحة التخزين الخاصة بك إذا كنت بحاجة إلى احتفاظ طويل الأمد.
أثناء التحقق المباشر بتاريخ 2026-03-12، لم يُرجِع غلاف الاستعلام في CometAPI نتيجة ضمن نافذة اختبار smoke-test مدتها 45 ثانية. تحقّق من زمن استجابة Polling في بيئتك الخاصة قبل الاعتماد على حلقات ضيقة.

التفويضات

Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

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

id
string
مطلوب

Prediction id returned by the create endpoint.

الاستجابة

200 - application/json

Current prediction state.

id
string
مطلوب
input
object
مطلوب
model
string
مطلوب
output
string[] | null
مطلوب
status
string
مطلوب
created_at
string
مطلوب
data_removed
boolean
مطلوب
logs
string
urls
object
error
string | null
metrics
object
version
string
started_at
string | null
completed_at
string | null