PicassoIA API
प्रेडिक्शन
प्रेडिक्शन किसी मॉडल का एक रन है: आप उसे बनाते हैं, पोल करते हैं और उसका आउटपुट पढ़ते हैं।
प्रेडिक्शन बनाना
POST /v1/models/{owner}/{name}/predictions, बॉडी { "input": { … } } के साथ।
- मॉडल के जॉब स्वीकार करते ही API जवाब देता है, आमतौर पर कुछ ही सेकंड में, और उस समय प्रेडिक्शन
startingस्टेट में होता है। API कभी भी नतीजे का इंतज़ार नहीं करता। - अगर प्रेडिक्शन तुरंत फ़ेल हो जाता है, तब भी जवाब
201ही होता है, जिसमें प्रेडिक्शनfailedस्टेट में और अपनेerrorके साथ होता है। उदाहरण के लिए, ऐसा तब होता है जब सेफ़्टी फ़िल्टर इनपुट को अस्वीकार कर देता है। - अगर कोई प्रेडिक्शन नहीं बना, तो जवाब एक त्रुटि होता है: अमान्य इनपुट, ज़रूरी प्लान न होना, एक साथ प्रगति में बहुत ज़्यादा प्रेडिक्शन, सेवा उपलब्ध न होना।
प्रेडिक्शन की सूची
GET /v1/predictions आपकी सभी keys से बने API प्रेडिक्शन लौटाता है, हर पेज पर 50, सबसे नए पहले।
nextअगले पेज का URL (…/v1/predictions?cursor=…) होता है, या आख़िरी पेज परnull।previousहमेशाnullहोता है।- picassoia.com पर आपके डिलीट किए गए प्रेडिक्शन इसमें शामिल नहीं होते।
कोई भी प्रेडिक्शन आपकी किसी भी key से देखा जा सकता है, लेकिन किसी और को वह कभी नहीं दिखता।
प्रेडिक्शन ऑब्जेक्ट
स्टेटस।
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 घंटे के भीतर यह पूरा नहीं हुआ।
आउटपुट। आउटपुट URL PicassoIA पर होस्ट किए जाते हैं। जिन फ़ाइलों को आप रखना चाहते हैं, उन्हें डाउनलोड कर लें।
पोलिंग और ETA
eta.next_poll_in_seconds बताता है कि अगला पोल कब करना फ़ायदेमंद है:
- अनुमानित समय के आधे पर।
- जब अनुमानित समय पूरा हो जाए।
- उसके बाद हर 2 सेकंड में।
उदाहरण के लिए, अगर अनुमान 10 सेकंड का है: 5 सेकंड बाद पोल करें, फिर 10 सेकंड बाद, फिर हर 2 सेकंड में। इससे ज़्यादा तेज़ी से पोल करने पर नतीजा जल्दी नहीं मिलता।
रद्द करना
POST /v1/predictions/{id}/cancel:
रद्द किया गया प्रेडिक्शन आपके एक साथ प्रगति में रहने वाले 5 प्रेडिक्शन में अपनी जगह तुरंत खाली कर देता है।