Een regel naar een NPC sturen

Parameters

Lingara-Versionheaderstringoptioneel

De API-versie waaronder dit verzoek wordt beantwoord. Zonder deze krijgt een toegangstoken de versie waaraan zijn client is gekoppeld, en een verzoek zonder token de huidige versie. De versie die nog in ontwikkeling is, bereik je alleen door die hier te noemen. Een onbekende versie geeft 400 met code api_version_unknown. GET /v1/versions toont de versies.

Request-body application/json

npcNpcverplicht

namestringverplicht

personastring | nulloptioneel

scenestring | nulloptioneel

source_langstringverplicht

target_langstringverplicht

levelintegerverplicht

linestringverplicht

historyarray of DialogueEntryoptioneel

Het gesprek tot nu toe, oudste eerst, hoogstens 12 regels. Jij bewaart het venster: Lingara slaat tussen beurten niets op. Stuur elk NPC-antwoord terug, ingekort tot de eerste 500 tekens.

speakerSpeakerverplicht

textstringverplicht

Antwoorden

200 Het antwoord van het personage, stukje voor stukje

Stream-events text/event-stream

Stuurt geen keepalive-commentaren.

delta TurnDelta

textstringverplicht

notice Notice

codestringverplicht

messagestringverplicht

done Done Beëindigt de stream

error StreamError Beëindigt de stream

Komt binnen het 200-antwoord aan. De statusregel is al verzonden, dus een fout nadat de stream is geopend wordt als deze gebeurtenis gemeld.

codestringverplicht

messagestringverplicht

plan_idstring | nulloptioneel

Fouten

402application/json

De aanroep van een client met verbruiksafrekening is geweigerd voordat die iets heeft uitgegeven. spend_cap_reached: de client of zijn account heeft zijn maandelijkse uitgavenlimiet bereikt; verhoog de limiet op de pagina Integraties. metered_billing_inactive: verbruiksafrekening is niet actief voor dit account; stel die in of werk de betaalmethode bij op de pagina Integraties.

410application/json

De API-versie waaronder dit verzoek wordt beantwoord, is stopgezet. Stuur een ondersteunde versie mee in Lingara-Version, of koppel de client aan een andere versie.

4XXapplication/json

Het verzoek is geweigerd. code geeft de reden aan en error beschrijft die in woorden.

503application/json · text/plain

De dienst is tijdelijk niet beschikbaar; probeer het opnieuw na het aantal seconden in Retry-After. Tijdens onderhoud is de body platte tekst in plaats van de foutenvelop.

5XXapplication/json

Het verzoek is geweigerd. code geeft de reden aan en error beschrijft die in woorden.

codestringverplicht

Waarom het verzoek is geweigerd, als stabiele code om op te vertakken: bijvoorbeeld insufficient_scope (403), rate_limited (429) en, voor een client met verbruiksafrekening, spend_cap_reached (402) en metered_billing_inactive (402).

errorstringverplicht

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

Liever een bibliotheek? Zie de sectie Bibliotheken.

Voorbeeldstream

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

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

event: done
data: {}