واجهة PicassoIA API
التنبؤات
التنبؤ هو تشغيل واحد لنموذج: تُنشئه، وتستعلم عنه دوريًا، وتقرأ مخرجاته.
إنشاء تنبؤ
أرسل POST /v1/models/{owner}/{name}/predictions مع جسم الطلب { "input": { … } }.
- تستجيب الواجهة بمجرد أن يقبل النموذج المهمة، عادةً في غضون ثوانٍ، بتنبؤ في الحالة
starting. ولا تنتظر النتيجة أبدًا. - إذا فشل التنبؤ على الفور، تظل الاستجابة
201، مع تنبؤ في الحالةfailedوحقلerrorالخاص به. يحدث هذا مثلًا عندما يرفض مرشّح الأمان المدخلات. - إذا لم يُنشأ أي تنبؤ، تكون الاستجابة خطأً: مدخلات غير صالحة، أو خطة غير مؤهلة، أو كثرة التنبؤات قيد التنفيذ، أو عدم توفر الخدمة.
سرد التنبؤات
يُرجع GET /v1/predictions تنبؤات API الخاصة بك، بواقع 50 تنبؤًا في كل صفحة، الأحدث أولًا، عبر جميع مفاتيحك.
- الحقل
nextهو عنوان URL للصفحة التالية (…/v1/predictions?cursor=…)، أوnullفي الصفحة الأخيرة. - الحقل
previousقيمتهnullدائمًا. - لا تُدرج التنبؤات التي حذفتها على picassoia.com.
يمكن الاطلاع على التنبؤ عبر أي من مفاتيحك، ولا يراه أي شخص آخر أبدًا.
كائن التنبؤ
الحالات.
التمييز بين starting وprocessing هو تقدير مبني على الموضع في قائمة الانتظار عند الإنشاء. ويكون التنبؤ الجديد دائمًا في الحالة starting. أما الحالات الثلاث الأخيرة فهي نهائية: التنبؤ الذي يصل إلى إحداها لا يتغير بعد ذلك أبدًا.
أخطاء التنبؤ الفاشل. تكون قيمة error في التنبؤ الفاشل إحدى الرسائل التالية:
- رفض مرشّح الأمان المدخلات أو المخرجات. وتنتهي الرسالة بالعبارة
(SAFETY_CHECKER_PICASSO_FILTER_S4). The prediction failed. You can try again.The prediction timed out. You can try again.لم يكتمل التنبؤ في غضون 3 ساعات.
المخرجات. تستضيف PicassoIA عناوين URL للمخرجات. نزّل الملفات التي تريد الاحتفاظ بها.
الاستعلام الدوري وتقدير الوقت (ETA)
يخبرك eta.next_poll_in_seconds بالوقت الذي يستحق فيه إجراء الاستعلام التالي:
- عند منتصف الوقت المقدَّر.
- عند بلوغ الوقت المقدَّر.
- ثم كل ثانيتين.
مثال بوقت مقدَّر قدره 10 ثوانٍ: استعلم بعد 5 ثوانٍ، ثم بعد 10 ثوانٍ، ثم كل ثانيتين. الاستعلام بوتيرة أسرع لن يمنحك النتيجة في وقت أبكر.
الإلغاء
عند إرسال POST /v1/predictions/{id}/cancel:
يُفسح التنبؤ المُلغى مكانه فورًا ضمن حد 5 تنبؤات قيد التنفيذ المسموح به لك.