ناردنی نۆرەیەک بۆ مامۆستا
وەشانی 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: {}ئەگەر وەرگێڕانێک و سەرچاوە ئینگلیزییەکە جیاواز بن، سەرچاوە ئینگلیزییەکە دروستە.