الانتقال إلى المحتوى الرئيسي
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 أولاً

ابدأ من Create Predictions - General.
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