For the complete documentation index, see llms.txt. This page is also available as Markdown.

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 डैशबोर्ड:

  1. अपने खाते में लॉग इन करें

  2. पर जाएँ API सेटिंग्स में अनुभाग

  3. अपना 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 प्रदान करता है:

Image
विवरण

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)

अंतिम अपडेट

क्या यह उपयोगी था?