Model Training API | API दस्तावेज़

हर भाषा में कमांड और कोड अंग्रेज़ी में ही रहेंगे। बड़े अक्षरों वाले प्लेसहोल्डर को अपने खाते और भुगतान किए गए कार्य के मानों से बदलें; साझा नोटबुक या लॉग में असली कुंजियाँ न डालें।

प्रशिक्षण की यात्रा

उद्देश्य काम की दिशा तय करता है; असली ट्रेनिंग विद्यार्थी मॉडल के भार बदलती है।

उद्देश्य काम और स्वीकृति के मानदंड तय करें
शिक्षक अधिकृत संदर्भ सामग्री तैयार करें
विद्यार्थी चुने हुए रनटाइम पर ट्रेन करें
मूल्यांकन आधार-मूल्य से तुलना करें
डिलीवरी अलग मॉडल या अडैप्टर निर्यात करें

काम कहाँ होता है

API समन्वय करती है; ग्राहक का निष्पादन परिवेश भारों को ट्रेन करता है। शिक्षक के भार स्थानांतरित नहीं होते।

आपका ऐप API कुंजी, उद्देश्य और स्वीकृत कार्य
FusionPointAI API सत्र, संदर्भ तक पहुँच और तैयार डेटा
ट्रेनिंग परिवेश SDK, विद्यार्थी मॉडल और GPU
स्थानीय नतीजा मॉडल पैकेज और मूल्यांकन रिपोर्ट

उद्देश्य से स्वतंत्र मॉडल तक

सेवा-प्रदाता की योजना और संदर्भ मॉडल चुनें, काम तय करें और विद्यार्थी मॉडल तथा रनटाइम कॉन्फ़िगर करें। TrainingProject स्वीकृत प्रशिक्षण सामग्री के लिए शिक्षक से अनुरोध कर सकता है। चुना हुआ रनटाइम विद्यार्थी मॉडल लोड करके उसके भार बदलता है। नतीजे में शिक्षक के भारों की प्रतिलिपि नहीं, बल्कि अलग मॉडल या अडैप्टर मिलता है।

मापने योग्य उद्देश्य चुनें, जैसे जर्मन दस्तावेज़ों का वर्गीकरण।
शिक्षक की पहुँच, विद्यार्थी मॉडल, रनटाइम और मूल्यांकन मानदंड अलग रखें।
पुराने सशुल्क कामों और सत्रों के लिए TrainingClient उपलब्ध है।

तीन हिस्से, तीन ज़िम्मेदारियाँ

आपकी API कुंजी सेवा तक पहुँच अधिकृत करती है; इससे GPU नहीं मिलता। API सत्रों, तैयार आँकड़ों और रिपोर्टों का समन्वय करती है। आपका निष्पादन परिवेश मेमोरी, स्टोरेज और कंप्यूट क्षमता देता है। SDK स्थानीय अनुकूलन करता है और नतीजे को पैकेज करता है। होस्टिंग FusionPointAI, आपके डेटा केंद्र या संगत नोटबुक निष्पादन परिवेश पर हो सकती है।

लॉगिन की जानकारी मॉडल फ़ाइलों और निर्यात किए पैकेज से बाहर रखें।
जाँचें कि शिक्षक को कौन-सा उद्देश्य और ट्रेनिंग सामग्री भेजी जा रही है।
समापन रिपोर्ट मॉडल की गुणवत्ता का स्वतंत्र प्रमाणन नहीं है।

पढ़ने का रास्ता चुनें

नए उपयोगकर्ता Quickstart, Concepts, Models, Datasets, Training और Evaluation क्रम से पढ़ सकते हैं। इंटीग्रेशन करने वाले सीधे API और Python संदर्भ पर जा सकते हैं। संचालन करने वालों को Recovery और Runtime deployment भी पढ़ना चाहिए।

कंप्यूट इस्तेमाल करने या शिक्षक से अनुरोध करने से पहले प्लान देखें।
तुलना के लिए अपरिवर्तित आधार मॉडल सुरक्षित रखें।
प्रशिक्षण और मूल्यांकन के नतीजे देखने के बाद ही आउटपुट निर्यात करें।

API संदर्भ

एंडपॉइंट	उद्देश्य और व्यवहार
`POST /api/v1/training/quotes` Authorization: Bearer `ai:training`	पात्र संदर्भ, योजना और विन्यास की पुष्टि करें; जवाब में मूल्य-प्रस्ताव का UUID, मुद्रा, `fixed_total` और `expires_at` मिलता है। स्वीकृत योजना और विद्यार्थी मॉडल की पात्र सेटिंग इस्तेमाल करें, क्लाइंट की मनमानी कीमतें नहीं।
`GET /api/v1/training/jobs` Authorization: Bearer `ai:training`	प्रमाणित ग्राहक के कार्यों की सूची देखें। संख्यात्मक पहचान-संख्या का अनुमान लगाने के बजाय मिली सूची और संसाधनों की पहचान-संख्या देखें।
`POST /api/v1/training/jobs` Authorization: Bearer `ai:training`	मान्य मूल्य-प्रस्ताव के UUID से खाते के स्वामित्व वाला कार्य बनाएँ। जवाब में कार्य की पहचान-संख्या, स्थिति, चालान की पहचान-संख्या और समय की जानकारी मिलती है; कार्य बनना भुगतान का प्रमाण नहीं है।
`GET /api/v1/training/jobs/{job}` Authorization: Bearer `ai:training`	कार्य के UUID से अपना काम देखें; इसमें उसकी ताज़ा प्रगति और फ़ाइल डिलीवरी की स्थिति शामिल है।
`GET /api/v1/training/jobs/{job}/artifacts/{file}` Authorization: Bearer `ai:training`	इस कार्य से जुड़ी प्रकाशित फ़ाइल डाउनलोड करें। स्थानीय SDK ZIP अपने आप अपलोड नहीं होती और इस मार्ग से उपलब्ध नहीं होती।
`POST /api/v1/training/sessions` Authorization: Bearer `ai:training`	अनुरोध के मुख्य भाग में कार्य का UUID, `runtime` और वैकल्पिक धनात्मक `reference_model_id` दें। नया या दोबारा इस्तेमाल किया गया सत्र लौटाया जाता है; संदर्भ केवल तैयारी शुरू होने से पहले बदला जा सकता है।
`GET /api/v1/training/sessions/{session}` Authorization: Bearer `ai:training`	अपने सत्र का विन्यास, आँकड़ा-संग्रह, रिपोर्ट और स्थिति पढ़ें। स्थिति पढ़ने से प्रशिक्षण शुरू नहीं होता।
`POST /api/v1/training/sessions/{session}/prepare` Authorization: Bearer `ai:training`	सीमित तैयारी-समूह माँगने के लिए खाली JSON ऑब्जेक्ट भेजें। अनुरोध-सीमा के भीतर, प्रगति होती रहे तो तैयारी पूरी होने तक इसे दोहराएँ।
`GET /api/v1/training/sessions/{session}/datasets/{split}` Authorization: Bearer `ai:training`	`train` या `validation` को `application/x-ndjson` के रूप में डाउनलोड करें। बाइट, SHA-256 और पंक्तियों की संख्या उसी सत्र के घोषणापत्र से मिलाएँ।
`POST /api/v1/training/sessions/{session}/events` Authorization: Bearer `ai:training`	वास्तविक स्थिति, `step`, `total_steps` और वैकल्पिक माप `loss`/`eval_loss` भेजें। केवल समर्थित स्थिति और त्रुटि-कोड इस्तेमाल करें।
`POST /api/v1/training/sessions/{session}/complete` Authorization: Bearer `ai:training`	`artifact_name` और पूरी वास्तविक प्रशिक्षण रिपोर्ट भेजें। सेवा प्रशिक्षण-विधि, आधार संशोधन, भारों में बदलाव, फ़ाइल का हैश और मूल्यांकन मानदंड जाँचती है।
`POST /api/v1/training/sessions/{session}/cancel` Authorization: Bearer `ai:training`	रद्द की जा सकने वाली सेवा-स्थिति के लिए खाली JSON ऑब्जेक्ट भेजें। ज़रूरत पड़ने पर अलग GPU प्रक्रिया स्वयं रोकें; यह pause/resume नहीं है।
`POST /api/v1/training/projects/authorize` Authorization: Bearer `ai:training`	`provider` और धनात्मक `reference_model_id` के साथ `POST` `/api/v1/training/projects/authorize` भेजें। यह प्रमाणित खाते की सशुल्क संदर्भ-मॉडल पहुँच फिर जाँचता है और उसी खाते के काम की पहचान, `grant`, सेवा-प्रदाता, संदर्भ मॉडल तथा पहुँच की समय-सीमा लौटाता है। इससे बिल नहीं बनता और भुगतान में बदलाव नहीं होता।
`POST /api/v1/training/projects/teacher` Authorization: Bearer `ai:training`	`provider`, `reference_model_id`, `action` (`curriculum` या `lessons`), `objective`, वैकल्पिक `topic`, `count` (1–4) और अधिकतम आठ `approved_examples` (हर एक अधिकतम 2,000 अक्षर) के साथ `POST` `/api/v1/training/projects/teacher` भेजें। जवाब में विषयों की सूची या पाठों के टेक्स्ट और विषय वाली पंक्तियाँ मिलती हैं। केवल स्वीकृत ट्रेनिंग सामग्री भेजें; वैलिडेशन या फ़ाइनल टेस्ट का डेटा कभी न भेजें।

अक्सर पूछे जाने वाले प्रश्न

क्या एक उद्देश्य से स्वचालित वर्कफ़्लो शुरू हो सकता है?

हाँ, इससे कॉन्फ़िगरेशन शुरू हो सकता है। वास्तविक ट्रेनिंग तभी शुरू होती है जब ज़रूरी अनुमतियाँ, मंज़ूर डेटा, अनुकूल स्टूडेंट मॉडल, सटीक कोटेशन, भुगतान और रनिंग की शर्तें पूरी हों।

क्या मुझे रेफ़रेंस मॉडल के मूल वेट्स मिलेंगे?

वेट्स अपने-आप ट्रांसफ़र नहीं होते। कस्टमर मॉडल अलग से ट्रेन किया जाता है; डिलीवरी और लाइसेंस मंज़ूर कोटेशन में तय होते हैं।

क्या प्रदर्शन रेफ़रेंस मॉडल जैसा ही होगा?

इसकी बिना शर्त गारंटी नहीं है। सहमत क्षमता लक्ष्यों को दस्तावेज़ित बेंचमार्क से जाँचा जाता है और मापे गए नतीजे रिपोर्ट किए जाते हैं।

क्या मुझे होस्टिंग खरीदनी होगी?

नहीं, अगर मंज़ूर डिलीवरी डाउनलोड करने योग्य आर्टिफ़ैक्ट है। सपोर्टेड होस्टेड डिप्लॉयमेंट का शुल्क एकमुश्त ट्रेनिंग प्रोजेक्ट से अलग है।

शामिल API पहुँच की अवधि पूरी होने पर क्या होगा?

दर्ज ट्रेनिंग अवधि के अंत में पहुँच खत्म हो जाती है। इसके बाद आप अलग उपलब्ध Unlimited API सब्सक्रिप्शन चुन सकते हैं।

क्या एक प्रदाता ट्रेनिंग प्लान में एक से अधिक रेफ़रेंस मॉडल शामिल हैं?

हाँ। एक प्लान में भुगतान की अवधि के दौरान उस प्रदाता के सभी उपलब्ध रेफ़रेंस मॉडल शामिल हैं। डेटासेट तैयार होना शुरू होने से पहले आप ट्रेनिंग सेशन के लिए मॉडल चुन या बदल सकते हैं; अलग सब्सक्रिप्शन नहीं लेना होगा। एक्सपायरी पर पहुँच खत्म हो जाती है और इससे पहले भी रद्द की जा सकती है।