अवलोकन
यह पेज Developer Platform API के साझा कनेक्शन विवरण, एंडपॉइंट, उत्तर, त्रुटियाँ और सीमाएँ बताता है। टूल के स्कीमा और वर्तमान कीमतेंGET /tools से लें।
बेस URL और हेडर
सभी पाथ इस बेस URL के बाद जोड़ें।एंडपॉइंट
मुख्य सार्वजनिक API एंडपॉइंट ये हैं।GET /tools/executions को limit, before, status और tool से फ़िल्टर करें। limit 1–100 है और डिफ़ॉल्ट 20 है।
टूल कैटलॉग
GET /tools के data में कैटलॉग का मूल्य संस्करण, मुद्रा, निष्पादन उपलब्धता और टूल सूची है।
हर टूल में ये जानकारी है:
name— निष्पादन URL और बॉडी का टूल नामdescriptionऔरcategory— उपयोग और वर्गavailable— आवश्यक बाहरी सेवाएँ कॉन्फ़िगर हैं और टूल उपलब्ध है या नहींinputSchemaऔरexample— इनपुट JSON Schema और उदाहरणmodels— चुनने योग्य मॉडल, उनके उदाहरण, उपलब्धता और कीमत विवरणprice— न्यूनतम शुल्क, बिलिंग इकाई और कीमत विवरण
available: true से निष्पादन तय नहीं होता। executionEnabled, अनुमतियाँ, बैलेंस और मासिक सीमाएँ भी लागू हैं।
उत्तर का प्रारूप
सफल उत्तर आम तौर पर नतीजाdata में रखते हैं।
error में स्थिति और संदेश रखती हैं।
Cache-Control: no-store है। कुंजियाँ, नतीजे या अस्थायी URL साझा कैश में न रखें।
त्रुटियाँ सँभालें
दोबारा भेजने से पहले स्थिति के अनुसार कारण जाँचें।उपयोग सीमाएँ
क्लाइंट में इन सीमाओं का ध्यान रखें।
कैटलॉग, कोटेशन, अपलोड, निष्पादन, स्थिति और पुनः प्रयास गिने जाते हैं। 429 से बचने के लिए अनावश्यक बार स्थिति न पूछें।
इनपुट अपलोड करें
स्थानीय तस्वीर, ऑडियो या वीडियो के लिए MIME प्रकार और Base64 डेटाPOST /tools/upload पर भेजें।
fileId के लिए id, प्रकार, आकार, SHA-256 और समाप्ति मिलते हैं। कैटलॉग के प्रारूप अनुसार source जैसे फ़ील्ड में दें। उसी प्रोजेक्ट में वही सामग्री समान ID देती है; पहले अपलोड से भंडारण अवधि नहीं बढ़ती।