Tuma mstari kwa NPC

Vigezo

Lingara-Versionheaderstringsi lazima

Toleo la API la kutumia kujibu ombi hili. Bila hilo, tokeni ya ufikiaji hupata toleo ambalo mteja wake ameunganishwa nalo, na ombi lisilo na tokeni hupata toleo la sasa. Toleo ambalo bado linaendelezwa linafikiwa tu kwa kulitaja hapa. Toleo lisilojulikana hujibiwa 400 pamoja na msimbo api_version_unknown. GET /v1/versions huorodhesha matoleo.

Mwili wa ombi application/json

npcNpcinahitajika

namestringinahitajika

personastring | nullsi lazima

scenestring | nullsi lazima

source_langstringinahitajika

target_langstringinahitajika

levelintegerinahitajika

linestringinahitajika

historyarray of DialogueEntrysi lazima

Mazungumzo hadi sasa, ya zamani zaidi kwanza, mistari 12 kwa zaidi. Wewe ndiye unayeshika dirisha: Lingara haihifadhi chochote kati ya zamu. Rudisha kila jibu la NPC likiwa limekatwa hadi herufi zake 500 za kwanza.

speakerSpeakerinahitajika

textstringinahitajika

Majibu

200 Jibu la mhusika, kipande kwa kipande

Matukio ya mtiririko text/event-stream

Haitumi maoni ya keepalive.

delta TurnDelta

textstringinahitajika

notice Notice

codestringinahitajika

messagestringinahitajika

done Done Humaliza mtiririko

error StreamError Humaliza mtiririko

Hufika ndani ya jibu la 200. Mstari wa hali umeshatumwa, kwa hivyo hitilafu baada ya mtiririko kufunguka huripotiwa kama tukio hili.

codestringinahitajika

messagestringinahitajika

plan_idstring | nullsi lazima

Hitilafu

402application/json

Simu ya mteja anayetozwa kwa matumizi imekataliwa kabla haijatumia chochote. spend_cap_reached: mteja au akaunti yake imefikia kikomo chake cha matumizi ya pesa cha kila mwezi; ongeza kikomo kwenye ukurasa wa Miunganisho. metered_billing_inactive: utozaji kwa matumizi haujawashwa kwa akaunti hii; uweke, au usasishe njia ya malipo, kwenye ukurasa wa Miunganisho.

410application/json

Toleo la API linalotumika kujibu ombi hili limesitishwa. Tuma toleo linalotumika katika Lingara-Version, au unganisha mteja na toleo lingine.

4XXapplication/json

Ombi limekataliwa. code inaeleza sababu, na error inaieleza kwa maneno.

503application/json · text/plain

Huduma haipatikani kwa muda; jaribu tena baada ya idadi ya sekunde zilizo katika Retry-After. Wakati wa matengenezo, mwili wa jibu ni maandishi ya kawaida badala ya bahasha ya hitilafu.

5XXapplication/json

Ombi limekataliwa. code inaeleza sababu, na error inaieleza kwa maneno.

codestringinahitajika

Sababu ya ombi kukataliwa, kama msimbo thabiti wa kufanyia maamuzi: kwa mfano insufficient_scope (403), rate_limited (429) na, kwa mteja anayetozwa kwa matumizi, spend_cap_reached (402) na metered_billing_inactive (402).

errorstringinahitajika

Mfano

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":"你好！"}]}'

Unapendelea maktaba? Tazama sehemu ya Maktaba.

Mfano wa mtiririko

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

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

event: done
data: {}