Stuur 'n reël na 'n NPC

Parameters

Lingara-Versionheaderstringopsioneel

Die API-weergawe waaronder hierdie versoek beantwoord word. Daarsonder kry 'n toegangstoken die weergawe waaraan sy kliënt gekoppel is, en 'n versoek sonder 'n token kry die huidige weergawe. Die weergawe wat nog ontwikkel word, is slegs bereikbaar deur dit hier te noem. 'n Onbekende weergawe gee 400 met kode api_version_unknown. GET /v1/versions lys die weergawes.

Versoekliggaam application/json

npcNpcverplig

namestringverplig

personastring | nullopsioneel

scenestring | nullopsioneel

source_langstringverplig

target_langstringverplig

levelintegerverplig

linestringverplig

historyarray of DialogueEntryopsioneel

Die gesprek tot dusver, oudste eerste, hoogstens 12 reëls. Jy hou die venster: Lingara stoor niks tussen beurte nie. Stuur elke NPC-antwoord terug, afgesny tot sy eerste 500 karakters.

speakerSpeakerverplig

textstringverplig

Antwoorde

200 Die karakter se antwoord, stuk vir stuk

Stroomgebeurtenisse text/event-stream

Stuur geen keepalive-opmerkings nie.

delta TurnDelta

textstringverplig

notice Notice

codestringverplig

messagestringverplig

done Done Beëindig die stroom

error StreamError Beëindig die stroom

Kom binne die 200-antwoord aan. Die statusreël is reeds gestuur, so 'n fout nadat die stroom oopgemaak is, word as hierdie gebeurtenis gerapporteer.

codestringverplig

messagestringverplig

plan_idstring | nullopsioneel

Foute

402application/json

'n Oproep van 'n gemeterde kliënt is geweier voordat dit iets bestee het. spend_cap_reached: die kliënt of sy rekening het sy maandelikse bestedingslimiet bereik; verhoog die limiet op die Integrasies-bladsy. metered_billing_inactive: gebruiksfakturering is nie aktief vir hierdie rekening nie; stel dit op, of werk die betaalmetode by, op die Integrasies-bladsy.

410application/json

Die API-weergawe waaronder hierdie versoek beantwoord word, is gestaak. Stuur 'n ondersteunde weergawe in Lingara-Version, of koppel die kliënt aan 'n ander weergawe.

4XXapplication/json

Die versoek is geweier. code sê hoekom, en error sê dit in woorde.

503application/json · text/plain

Die diens is tydelik onbeskikbaar; probeer weer na die aantal sekondes in Retry-After. Tydens onderhoud is die liggaam gewone teks eerder as die foutomhulsel.

5XXapplication/json

Die versoek is geweier. code sê hoekom, en error sê dit in woorde.

codestringverplig

Waarom die versoek geweier is, as 'n stabiele kode om op te vertak: byvoorbeeld insufficient_scope (403), rate_limited (429) en, vir 'n gemeterde kliënt, spend_cap_reached (402) en metered_billing_inactive (402).

errorstringverplig

Voorbeeld

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

Verkies jy 'n biblioteek? Sien die Biblioteke-afdeling.

Voorbeeldstroom

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

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

event: done
data: {}