Rêzekê ji NPCyekê re bişîne

Parametre

Lingara-Versionheaderstringvebijarkî

Guhertoya API ya ku ev daxwaz pê tê bersivandin. Bêyî wê, tokena gihîştinê guhertoya ku klientê wê pê ve girêdayî ye distîne, û daxwazeke bê token guhertoya niha distîne. Guhertoya ku hîn di pêşxistinê de ye tenê bi binavkirina wê li vir tê gihîştin. Guhertoyeke nenas bi 400 û koda api_version_unknown tê bersivandin. GET /v1/versions guhertoyan rêz dike.

Naveroka daxwazê application/json

npcNpcpêwîst

namestringpêwîst

personastring | nullvebijarkî

scenestring | nullvebijarkî

source_langstringpêwîst

target_langstringpêwîst

levelintegerpêwîst

linestringpêwîst

historyarray of DialogueEntryvebijarkî

Axaftina heta niha, ya herî kevn pêşî, herî zêde 12 rêz. Pencere li cem te dimîne: Lingara di navbera doran de tiştekî tomar nake. Her bersiva NPCyê bi qutkirina 500 tîpên wê yên pêşîn vegerîne.

speakerSpeakerpêwîst

textstringpêwîst

Bersiv

200 Bersiva karakterê, perçe bi perçe

Bûyerên streamê text/event-stream

Tu şîroveyên keepalive naşîne.

delta TurnDelta

textstringpêwîst

notice Notice

codestringpêwîst

messagestringpêwîst

done Done Weşanê diqedîne

error StreamError Weşanê diqedîne

Di nav bersiva 200 de tê. Rêza rewşê berê hatiye şandin, ji ber vê yekê têkçûnek piştî vebûna weşanê wekî vê bûyerê tê ragihandin.

codestringpêwîst

messagestringpêwîst

plan_idstring | nullvebijarkî

Çewtî

402application/json

Bangeke klienteke pîvandî hat redkirin berî ku tiştek xerc bike. spend_cap_reached: klient an hesabê wê gihîştiye sînorê xercê yê mehane; sînor li rûpela Entegrasyon bilind bike. metered_billing_inactive: fatûrekirina li gorî bikaranînê ji bo vî hesabî ne çalak e; wê li rûpela Entegrasyon saz bike an rêbaza dayînê nû bike.

410application/json

Guhertoya API ya ku ev daxwaz pê tê bersivandin hate rawestandin. Guhertoyeke piştgirîkirî di Lingara-Version de bişîne, an klientê bi guhertoyeke din ve girê bide.

4XXapplication/json

Daxwaz hate redkirin. code sedemê dibêje, û error wê bi gotinan dibêje.

503application/json · text/plain

Xizmet bi demkî ne berdest e; piştî hejmara çirkeyên di Retry-After de dîsa biceribîne. Di dema lênêrînê de naverok nivîsa sade ye, ne zerfa çewtiyê.

5XXapplication/json

Daxwaz hate redkirin. code sedemê dibêje, û error wê bi gotinan dibêje.

codestringpêwîst

Çima daxwaz hat redkirin, wek kodeke domdar ku mirov li gorî wê şax dike: bo nimûne insufficient_scope (403), rate_limited (429) û, ji bo klienteke pîvandî, spend_cap_reached (402) û metered_billing_inactive (402).

errorstringpêwîst

Mînak

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

Pirtûkxaneyek tercîh dikî? Beşa Pirtûkxaneyan bibîne.

Mînaka streamê

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

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

event: done
data: {}