یک جمله به یک شخصیت غیربازیکن بفرستید

پارامترها

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 میان نوبت‌ها هیچ چیزی ذخیره نمی‌کند. هر پاسخ شخصیت را تا ۵۰۰ حرف اولش کوتاه کرده دوباره بفرستید.

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