किसी NPC को एक पंक्ति भेजें

API संस्करण 2026-10-virile-dragon

post https://api.getlingara.com/v1/embed/dialogue/turns

खिलाड़ी की line एक किरदार को भेजता है और किरदार का जवाब delta इवेंट के रूप में स्ट्रीम करता है, जो done पर ख़त्म होता है। किरदार केवल target_lang बोलता है, खिलाड़ी के level पर। कुछ भी सहेजा नहीं जाता: अब तक की बातचीत history में भेजें। हर बारी का बिल एक metered क्लाइंट को जाता है; किसी भी अन्य कॉलर को 403 embed_needs_metered मिलता है।

स्कोप embed:play

पैरामीटर

Lingara-Versionheaderstringवैकल्पिक: वह API संस्करण जिसके अंतर्गत इस अनुरोध का उत्तर दिया जाए। इसके बिना, एक्सेस टोकन को वह संस्करण मिलता है जिससे उसका क्लाइंट जुड़ा है, और बिना टोकन वाले अनुरोध को वर्तमान संस्करण मिलता है। विकासाधीन संस्करण तक केवल उसे यहाँ नाम देकर पहुँचा जा सकता है। अज्ञात संस्करण का उत्तर 400 और कोड api_version_unknown होता है। GET /v1/versions संस्करणों की सूची देता है।

अनुरोध बॉडी `application/json`

npcNpcआवश्यक

namestringआवश्यक
personastring | nullवैकल्पिक

scenestring | nullवैकल्पिक

source_langstringआवश्यक

target_langstringआवश्यक

levelintegerआवश्यक

linestringआवश्यक

historyarray of DialogueEntryवैकल्पिक

अब तक की बातचीत, सबसे पुरानी पहले, अधिकतम 12 पंक्तियाँ। विंडो आप रखते हैं: Lingara बारियों के बीच कुछ भी नहीं सहेजता। NPC का हर जवाब उसके पहले 500 अक्षरों तक काटकर वापस भेजें।

speakerSpeakerआवश्यक
textstringआवश्यक

प्रतिक्रियाएँ

200 किरदार का जवाब, टुकड़े-टुकड़े में

स्ट्रीम इवेंट `text/event-stream`

कोई keepalive टिप्पणी नहीं भेजता।

delta TurnDelta

textstringआवश्यक

notice Notice

codestringआवश्यक
messagestringआवश्यक

done Done स्ट्रीम समाप्त करता है

error StreamError स्ट्रीम समाप्त करता है

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आवश्यक

उदाहरण

curl -N -X POST "https://api.getlingara.com/v1/embed/dialogue/turns" \
  -H "Authorization: Bearer $LINGARA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"npc":{"name":"Auntie Lin","persona":"a street-food vendor who likes to haggle"},"scene":"A night market in Taipei, just after rain","source_lang":"en","target_lang":"zh","level":3,"line":"How much are the dumplings?","history":[{"speaker":"npc","text":"来来来，刚出锅的饺子！"},{"speaker":"player","text":"你好！"}]}'

लाइब्रेरी पसंद है? लाइब्रेरी अनुभाग देखें।

उदाहरण स्ट्रीम

event: delta
data: {"text":"饺子十块钱一盘，"}

event: delta
data: {"text":"要几盘？"}

event: done
data: {}

यदि किसी अनुवाद और अंग्रेज़ी संदर्भ में अंतर हो, तो अंग्रेज़ी संदर्भ ही मान्य है।