یوه کرښه NPC ته واستوئ

پیرامیټرونه

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 هر ځواب تر لومړیو ۵۰۰ تورو پورې لنډ کړئ او بېرته یې واستوئ.

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: {}