CLI और SDK गाइड
अवलोकन
Clore.ai प्रदान करता है REST API जो GPU मार्केटप्लेस तक पूर्ण प्रोग्रामेटिक पहुंच सक्षम करता है — सर्वर सूचीबद्ध करना, ऑर्डर बनाना, डिप्लॉयमेंट की निगरानी करना, और रेंटल रद्द करना।
नोट: इस समय कोई आधिकारिक CLI बाइनरी उपलब्ध नहीं है। सभी ऑटोमेशन सीधे REST API के माध्यम से, जैसे उपकरणों का उपयोग करके किया जाता है
curl, Python, या Node.js.
आधार URL: https://api.clore.ai/v1
प्रतिक्रिया प्रारूप: JSON. प्रत्येक प्रतिक्रिया में एक code फ़ील्ड होता है जो स्थिति दर्शाता है।
प्रमाणीकरण
से अपना API key जनरेट करें Clore.ai डैशबोर्ड:
अपने खाते में लॉग इन करें
पर जाएँ API सेटिंग्स में अनुभाग
अपना API key जनरेट करें और कॉपी करें
हेडर प्रारूप:
auth: YOUR_API_KEY⚠️ महत्वपूर्ण: auth हेडर है
auth, नहींAuthorization: Bearer। गलत प्रारूप का उपयोग करने पर code लौटेगा3(अमान्य API टोकन)।
उदाहरण:
curl -H 'auth: YOUR_API_KEY' 'https://api.clore.ai/v1/marketplace'त्वरित शुरुआत
मार्केटप्लेस सर्वर सूचीबद्ध करें
सभी उपलब्ध GPU सर्वरों को ब्राउज़ करें:
प्रतिक्रिया:
अपने ऑर्डर प्राप्त करें
पूर्ण/समाप्त ऑर्डर शामिल करें:
ऑर्डर बनाएं (ऑन-डिमांड)
प्रतिक्रिया:
स्पॉट ऑर्डर बनाएं
स्पॉट ऑर्डर सस्ते होते हैं, लेकिन उन पर अधिक बोली लग सकती है। आप प्रति दिन अपनी कीमत तय करते हैं:
स्वतः-नवीनीकरण के साथ 48 घंटे के लिए किराए पर लें
ऐसे सर्वर पर जिसकी अधिकतम किराया अवधि (mrl) 48 घंटे से कम है, तो ऑर्डर हर अवधि के अंत में उस समय होस्ट की कीमत पर नवीनीकृत होता है, जब तक वह आपकी auto_renew_max_price प्रति दिन सीमा के भीतर हो, और 48 घंटे समाप्त होने पर समाप्त हो जाता है। छोड़ दें rental_hours को, ताकि आप रद्द करने तक नवीनीकरण जारी रहे। बिना auto_renew, सर्वर की mrl से अधिक घंटे अस्वीकार किए जाते हैं rental_hours_exceeds_mrl.
प्रतिक्रिया:
ऑर्डर की स्थिति जांचें
सक्रिय ऑर्डरों में शामिल हैं pub_cluster (होस्टनाम) और tcp_ports SSH पहुंच के लिए:
अपने किराए के सर्वर में SSH करें:
स्वतः-नवीनीकरण बदलें
नवीनीकरण चालू करें, मूल्य सीमा बदलें, या चल रहे ऑन-डिमांड ऑर्डर के कुल घंटे बदलें। छोड़े गए फ़ील्ड अपना मान बनाए रखते हैं, और "rental_hours": null घंटे की सीमा हटा देता है। यह अनुरोध ऑर्डर को तब तक नवीनीकृत रखता है जब तक आप इसे रद्द नहीं करते:
भेजें { "order_id": 38, "auto_renew": false } नवीनीकरण रोकने के लिए; फिर ऑर्डर अपनी वर्तमान अवधि के साथ समाप्त होता है। अवधि के अंतिम 60 सेकंड में अनुरोध को अस्वीकार किया जाता है renewal_in_progress; ऑर्डर के नवीनीकृत या समाप्त होने के बाद पुनः प्रयास करें। my_orders परिणाम दिखाता है auto_renew, auto_renew_max_price, rental_hours, rental_end और term_end.
नवीनीकरण इतिहास पढ़ें
प्रतिक्रिया (नवीनतम पहले, प्रत्येक नवीनीकरण निर्णय के लिए एक पंक्ति, नवीनीकृत या अस्वीकृत):
ऑर्डर रद्द करें
वैकल्पिक रूप से सर्वर के साथ किसी समस्या की रिपोर्ट करें:
Python SDK
requests लाइब्रेरी का उपयोग करने वाला एक हल्का रैपर। requests लाइब्रेरी। इसे इस प्रकार इंस्टॉल करें:
CloreClient वर्ग
पूर्ण कार्यशील उदाहरण
Node.js उदाहरण
नेटिव का उपयोग करते हुए fetch API (Node.js 18+):
सामान्य वर्कफ़्लो
सबसे सस्ता RTX 4090 खोजें और उसे किराये पर लें
मेरे ऑर्डर मॉनिटर करें
जब कीमत X से नीचे आए तो ऑटो-रेंट करें
WebSocket
Clore.ai REST API वर्तमान में WebSocket endpoint प्रदान नहीं करता। रीयल-टाइम मॉनिटरिंग के लिए, उचित अंतराल के साथ polling का उपयोग करें (नीचे rate limits देखें).
दर सीमाएँ
अधिकांश एंडपॉइंट
1 अनुरोध/सेकंड
create_order
1 अनुरोध/5 सेकंड
set_spot_price (कीमत में कमी)
प्रति एक बार 600 सेकंड
दर-सीमा प्रतिक्रिया (कोड 5):
सर्वोत्तम प्रथाएँ:
जोड़ें
time.sleep(1)लगातार API कॉल्स के बीचके लिए
create_orderके बीच कम से कम 5 सेकंड प्रतीक्षा करेंमॉनिटरिंग लूप्स के लिए 60+ सेकंड के polling अंतराल का उपयोग करें
यदि आपको इसे बार-बार क्वेरी करना हो, तो marketplace डेटा को स्थानीय रूप से cache करें
Python helper:
त्रुटि प्रबंधन
हर API प्रतिक्रिया में एक code फ़ील्ड शामिल होता है। 0 का मान
त्रुटि कोड
0
सफलता
—
1
डेटाबेस त्रुटि
देरी के बाद पुनः प्रयास करें
2
अमान्य इनपुट डेटा
अपने request body/parameters जाँचें
3
अमान्य API token
डैशबोर्ड में अपनी API key सत्यापित करें
4
अमान्य endpoint
endpoint URL जाँचें
5
दर सीमा पार हो गई (1 req/sec)
अनुरोधों के बीच देरी जोड़ें
6
एप्लिकेशन त्रुटि (देखें error फ़ील्ड)
विवरण के लिए error फ़ील्ड पढ़ें
कोड 6 उप-त्रुटियाँ
error मान
अर्थ
exceeded_max_step
स्पॉट कीमत में कमी बहुत बड़ी है; जाँचें max_step फ़ील्ड
can_lower_every_600_seconds
स्पॉट कीमत फिर से कम करने से पहले प्रतीक्षा करनी होगी; जाँचें time_to_lowering
Python त्रुटि प्रबंधन उदाहरण
JavaScript त्रुटि प्रबंधन उदाहरण
उपलब्ध Docker Images
Clore.ai GPU workloads के लिए अनुकूलित तैयार images प्रदान करता है:
cloreai/ubuntu20.04-jupyter
Ubuntu 20.04 + JupyterLab
cloreai/ubuntu22.04-jupyter
Ubuntu 22.04 + JupyterLab
आप कोई भी public Docker Hub image भी उपयोग कर सकते हैं। GPU access के लिए, CUDA-सक्षम images उपयोग करें, जैसे:
पोर्ट फ़ॉरवर्डिंग
ऑर्डर बनाते समय, expose करने के लिए ports निर्दिष्ट करें:
"tcp"— प्रत्यक्ष TCP पोर्ट फ़ॉरवर्डिंग (SSH, custom servers के लिए)"http"— HTTPS proxy (Jupyter, web UIs के लिए)। प्रतिhttp_portफ़ील्ड में केवल एक HTTP port की अनुमति है.
ऑर्डर बनने के बाद, कनेक्शन विवरण दिखाई देते हैं my_orders:
SSH के माध्यम से कनेक्ट करें:
ब्राउज़र के माध्यम से Jupyter access करें: https://n1.c1.clorecloud.net (का उपयोग करता है http_port)
अंतिम अपडेट
क्या यह उपयोगी था?