Lähetä repliikki NPC:lle

Parametrit

Lingara-Versionheaderstringvalinnainen

API-versio, jolla tähän pyyntöön vastataan. Ilman sitä käyttötunnus saa version, johon sen asiakas on kiinnitetty, ja pyyntö ilman tunnusta saa nykyisen version. Vielä kehitteillä olevaan versioon pääsee vain nimeämällä sen tässä. Tuntemattomaan versioon vastataan 400 koodilla api_version_unknown. GET /v1/versions luettelee versiot.

Pyynnön runko application/json

npcNpcpakollinen

namestringpakollinen

personastring | nullvalinnainen

scenestring | nullvalinnainen

source_langstringpakollinen

target_langstringpakollinen

levelintegerpakollinen

linestringpakollinen

historyarray of DialogueEntryvalinnainen

Tähänastinen keskustelu vanhimmasta alkaen, enintään 12 riviä. Sinä säilytät ikkunan: Lingara ei tallenna mitään vuorojen välillä. Lähetä jokainen NPC:n vastaus takaisin lyhennettynä ensimmäiseen 500 merkkiin.

speakerSpeakerpakollinen

textstringpakollinen

Vastaukset

200 Hahmon vastaus, pala kerrallaan

Virran tapahtumat text/event-stream

Ei lähetä keepalive-kommentteja.

delta TurnDelta

textstringpakollinen

notice Notice

codestringpakollinen

messagestringpakollinen

done Done Päättää virran

error StreamError Päättää virran

Saapuu 200-vastauksen sisällä. Tilarivi on jo lähetetty, joten virran avaamisen jälkeinen virhe ilmoitetaan tänä tapahtumana.

codestringpakollinen

messagestringpakollinen

plan_idstring | nullvalinnainen

Virheet

402application/json

Käytön mukaan laskutettavan asiakkaan kutsu hylättiin ennen kuin se kulutti mitään. spend_cap_reached: asiakas tai sen tili on saavuttanut kuukausittaisen kulutusrajansa; nosta rajaa Integraatiot-sivulla. metered_billing_inactive: käytön mukainen laskutus ei ole tällä tilillä käytössä; ota se käyttöön tai päivitä maksutapa Integraatiot-sivulla.

410application/json

API-versio, jolla tähän pyyntöön vastataan, on lopetettu. Lähetä tuettu versio Lingara-Version-otsakkeessa tai kiinnitä asiakas toiseen versioon.

4XXapplication/json

Pyyntö hylättiin. code kertoo syyn, ja error kertoo sen sanoin.

503application/json · text/plain

Palvelu ei ole tilapäisesti käytettävissä; yritä uudelleen Retry-After-otsakkeen ilmoittaman sekuntimäärän jälkeen. Huoltokatkon aikana runko on pelkkää tekstiä virhekehyksen sijaan.

5XXapplication/json

Pyyntö hylättiin. code kertoo syyn, ja error kertoo sen sanoin.

codestringpakollinen

Miksi pyyntö hylättiin, pysyvänä koodina, jonka mukaan voit haarautua: esimerkiksi insufficient_scope (403), rate_limited (429) ja käytön mukaan laskutettavalle asiakkaalle spend_cap_reached (402) ja metered_billing_inactive (402).

errorstringpakollinen

Esimerkki

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

Käytätkö mieluummin kirjastoa? Katso Kirjastot-osio.

Esimerkkivirta

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

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

event: done
data: {}