Magpadala ng linya sa isang NPC

Mga parameter

Lingara-Versionheaderstringopsyonal

Ang bersyon ng API na gagamitin sa pagsagot sa kahilingang ito. Kung wala ito, makukuha ng access token ang bersyong naka-pin sa client nito, at makukuha ng kahilingang walang token ang kasalukuyang bersyon. Maaabot lang ang bersyong dine-develop pa sa pamamagitan ng pagpangalan dito. Ang hindi kilalang bersyon ay sinasagot ng 400 na may code na api_version_unknown. Inililista ng GET /v1/versions ang mga bersyon.

Katawan ng kahilingan application/json

npcNpckailangan

namestringkailangan

personastring | nullopsyonal

scenestring | nullopsyonal

source_langstringkailangan

target_langstringkailangan

levelintegerkailangan

linestringkailangan

historyarray of DialogueEntryopsyonal

Ang usapan hanggang ngayon, pinakaluma muna, hanggang 12 linya. Ikaw ang nagtatabi ng window: walang iniimbak ang Lingara sa pagitan ng mga turn. Ibalik ang bawat sagot ng NPC na pinutol sa unang 500 character nito.

speakerSpeakerkailangan

textstringkailangan

Mga tugon

200 Ang sagot ng karakter, paisa-isang bahagi

Mga event ng stream text/event-stream

Hindi nagpapadala ng mga keepalive na komento.

delta TurnDelta

textstringkailangan

notice Notice

codestringkailangan

messagestringkailangan

done Done Tinatapos ang stream

error StreamError Tinatapos ang stream

Dumarating sa loob ng 200 na tugon. Naipadala na ang status line, kaya ang pagkabigo matapos mabuksan ang stream ay iniuulat bilang event na ito.

codestringkailangan

messagestringkailangan

plan_idstring | nullopsyonal

Mga error

402application/json

Tinanggihan ang tawag ng isang metered client bago ito nakagastos ng anuman. spend_cap_reached: naabot na ng client o ng account nito ang buwanang limitasyon sa paggastos; itaas ang limitasyon sa pahinang Mga integration. metered_billing_inactive: hindi aktibo ang usage billing para sa account na ito; i-set up ito, o i-update ang paraan ng pagbabayad, sa pahinang Mga integration.

410application/json

Itinigil na ang bersyon ng API na ginagamit sa pagsagot sa kahilingang ito. Magpadala ng suportadong bersyon sa Lingara-Version, o i-pin ang client sa ibang bersyon.

4XXapplication/json

Tinanggihan ang kahilingan. Sinasabi ng code kung bakit, at ipinapaliwanag ito ng error sa mga salita.

503application/json · text/plain

Pansamantalang hindi available ang serbisyo; subukang muli pagkatapos ng bilang ng segundong nasa Retry-After. Habang may maintenance, plain text ang body sa halip na ang error envelope.

5XXapplication/json

Tinanggihan ang kahilingan. Sinasabi ng code kung bakit, at ipinapaliwanag ito ng error sa mga salita.

codestringkailangan

Kung bakit tinanggihan ang request, bilang isang matatag na code na mapagbabatayan ng iyong programa: halimbawa insufficient_scope (403), rate_limited (429) at, para sa isang metered client, spend_cap_reached (402) at metered_billing_inactive (402).

errorstringkailangan

Halimbawa

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

Mas gusto ang library? Tingnan ang seksyong Mga library.

Halimbawang stream

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

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

event: done
data: {}