ट्यूटर को एक बारी भेजें
API संस्करण 2026-10-affable-towhee
ट्यूटर को एक संदेश भेजता है और जवाब को delta इवेंट के रूप में स्ट्रीम करता है, done के साथ समाप्त। कुछ भी संग्रहीत नहीं होता: हाल की बातचीत history में भेजें, अधिकतम 20 प्रविष्टियाँ। character और situation दृश्य तय करते हैं। सशुल्क प्लान आवश्यक है।
स्कोप tutor:converse
पैरामीटर
Lingara-Versionheaderstringवैकल्पिक- वह API संस्करण जिसके अंतर्गत इस अनुरोध का उत्तर दिया जाए। इसके बिना, एक्सेस टोकन को वह संस्करण मिलता है जिससे उसका क्लाइंट जुड़ा है, और बिना टोकन वाले अनुरोध को वर्तमान संस्करण मिलता है। विकासाधीन संस्करण तक केवल उसे यहाँ नाम देकर पहुँचा जा सकता है। अज्ञात संस्करण का उत्तर
400और कोडapi_version_unknownहोता है।GET /v1/versionsसंस्करणों की सूची देता है।
अनुरोध बॉडी application/json
messagestringआवश्यकhistoryarray of TurnEntryवैकल्पिकroleTurnRoleआवश्यकcontentstringआवश्यक
source_langstringआवश्यकtarget_langstringआवश्यकlevelinteger | nullवैकल्पिकcharacterstring | nullवैकल्पिकsituationstring | nullवैकल्पिक
प्रतिक्रियाएँ
200 ट्यूटर का जवाब, टुकड़ा-टुकड़ा
स्ट्रीम इवेंट text/event-stream
कोई keepalive टिप्पणी नहीं भेजता।
-
deltaTurnDelta -
textstringआवश्यक
-
noticeNotice -
codestringआवश्यकmessagestringआवश्यक
-
doneDone स्ट्रीम समाप्त करता है -
errorStreamError स्ट्रीम समाप्त करता है -
200 प्रतिक्रिया के भीतर आता है। स्थिति पंक्ति पहले ही भेजी जा चुकी है, इसलिए स्ट्रीम खुलने के बाद की विफलता इस इवेंट के रूप में बताई जाती है।
codestringआवश्यकmessagestringआवश्यकplan_idstring | nullवैकल्पिक
त्रुटियाँ
402application/json- मीटर्ड क्लाइंट की कॉल कुछ भी खर्च होने से पहले ही अस्वीकार कर दी गई।
spend_cap_reached: क्लाइंट या उसका खाता अपनी मासिक खर्च सीमा तक पहुँच गया है; इंटीग्रेशन पेज पर सीमा बढ़ाएँ।metered_billing_inactive: इस खाते के लिए उपयोग-आधारित बिलिंग सक्रिय नहीं है; इंटीग्रेशन पेज पर इसे सेट अप करें या भुगतान का तरीका अपडेट करें। 410application/json- जिस API संस्करण के अंतर्गत इस अनुरोध का उत्तर दिया जाता है, वह बंद कर दिया गया है।
Lingara-Versionमें कोई समर्थित संस्करण भेजें, या क्लाइंट को किसी दूसरे संस्करण से जोड़ें। 4XXapplication/json- अनुरोध अस्वीकार कर दिया गया।
codeकारण बताता है, औरerrorउसे शब्दों में बताता है। 503application/json · text/plain- सेवा अस्थायी रूप से अनुपलब्ध है;
Retry-Afterमें दिए गए सेकंड के बाद पुनः प्रयास करें। रखरखाव के दौरान बॉडी त्रुटि लिफ़ाफ़े के बजाय सादा टेक्स्ट होती है। 5XXapplication/json- अनुरोध अस्वीकार कर दिया गया।
codeकारण बताता है, औरerrorउसे शब्दों में बताता है।
codestringआवश्यकअनुरोध क्यों अस्वीकार किया गया, एक स्थिर कोड के रूप में जिसके आधार पर आप शाखा बना सकते हैं: उदाहरण के लिए
insufficient_scope(403),rate_limited(429) और, मीटर्ड क्लाइंट के लिए,spend_cap_reached(402) औरmetered_billing_inactive(402)।errorstringआवश्यक
उदाहरण
लाइब्रेरी पसंद है? लाइब्रेरी अनुभाग देखें।
उदाहरण स्ट्रीम
event: delta
data: {"text":"两斤荔枝,"}
event: delta
data: {"text":"一共三十块。"}
event: done
data: {}यदि किसी अनुवाद और अंग्रेज़ी संदर्भ में अंतर हो, तो अंग्रेज़ी संदर्भ ही मान्य है।