ښوونکي ته یو وار لېږل
د API نسخه 2026-10-affable-towhee
ښوونکي ته یو پیغام لېږي او ځواب د delta پېښو په ډول د جریان له لارې راګرځوي، چې په done پای ته رسېږي. هېڅ شی نه ساتل کېږي: وروستۍ خبرې اترې په history کې ولېږئ، تر ۲۰ ننوتو پورې. 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: {}که یوه ژباړه له انګلیسي مرجع سره توپیر ولري، انګلیسي مرجع سمه ده.