मुख्य सामग्री पर जाएं

​
अवलोकन

यह पेज कोटेशन, रकम आरक्षण, असिंक्रोनस निष्पादन, अंतिम शुल्क और आर्टिफ़ैक्ट बताता है। लंबे काम को ID से ट्रैक करें, HTTP कनेक्शन खुला न रखें।

​
निष्पादन और बिलिंग समझें

POST /tools/quote इनपुट का मूल्य संस्करण, न्यूनतम शुल्क और अधिकतम आरक्षण देता है। कोटेशन मुफ़्त है: बाहरी सेवा नहीं बुलाता और रकम आरक्षित नहीं करता। कोटेशन के tool और arguments रखें और जोड़ें:
  • priceVersion — कोटेशन का मूल्य संस्करण
  • maximumChargeMicros — कोटेशन की अधिकतम आरक्षित रकम
कीमत बदलने या सीमा कम होने पर काम शुरू होने से पहले अनुरोध अस्वीकार होता है। नया कोटेशन लेकर जाँचें।

​
रकम आरक्षित और शुल्क अंतिम करें

सशुल्क काम स्वीकार होने पर प्रीपेड USD बैलेंस से अधिकतम रकम अस्थायी रूप से रखी जाती है। अंत में वास्तविक शुल्क तय होता है और बची रकम लौटती है। विफलता या रद्द होने पर भी पहले से लगे बाहरी खर्च का शुल्क लग सकता है। अधिकतम आरक्षण से ऊपर अपने आप शुल्क नहीं लगता।

​
स्थिति पूछें

स्वीकृति पर HTTP 202 और ID मिलता है। Retry-After: 5 के अनुसार उसी ID को कम से कम पाँच सेकंड के अंतराल पर पूछें।

​
दोहराव रोकने के लिए इडेम्पोटेंसी

इडेम्पोटेंसी कुंजी एक अनुरोध को गलती से कई बार भेजने पर अलग निष्पादन बनने से रोकती है। सशुल्क POST /tools/{tool} में Idempotency-Key आवश्यक है। कुंजी में 8–128 अक्षर हों: अंग्रेज़ी अक्षर, अंक, ., _, : या -। हर तार्किक अनुरोध की एक कुंजी बनाएँ और ID के साथ रखें।
  • वही API कुंजी, बॉडी और इडेम्पोटेंसी कुंजी वही निष्पादन लौटाते हैं।
  • उसी इडेम्पोटेंसी कुंजी पर बॉडी या API कुंजी बदलने से HTTP 409 आता है।
  • कनेक्शन टूटे तो बॉडी और इडेम्पोटेंसी कुंजी बदले बिना भेजें।
  • needs_review काम नई कुंजी से भेजना एक और सशुल्क निष्पादन बनाता है।
उत्तर न मिलना अस्वीकृति का प्रमाण नहीं है। नतीजा अज्ञात हो तो नई कुंजी न बनाएँ।

​
निष्पादन रद्द करें

POST /tools/executions/{id}/cancel अभी शुरू न हुए काम को रोकने का अनुरोध है। निष्पादन बनाने वाली कुंजी या प्रोजेक्ट ADMIN यह कर सकता है। बाहरी प्रक्रिया शुरू हो चुकी हो तो काम और खर्च वापस नहीं हो सकते। cancelRequested, अंतिम status और chargedMicros जाँचें।

​
आर्टिफ़ैक्ट लें

बनी तस्वीरें, ऑडियो और वीडियो output.artifacts में ID, प्रकार, आकार, हैश और समाप्ति के साथ मिलते हैं। नतीजे में फ़ाइलें या स्थायी URL नहीं होते। GET /tools/executions/{id}/artifacts/{artifactId}/download अधिकतम पाँच मिनट मान्य URL देता है। रखी फ़ाइलें 30 दिन बाद समाप्त होती हैं। अस्थायी URL भी निजी डेटा तक पहुँच देते हैं। इन्हें लॉग या सार्वजनिक न करें और इनमें Developer Platform कुंजी न जोड़ें।

​
संबंधित पेज

पहले निष्पादन और एंडपॉइंट के लिए ये पेज देखें।