送一句話分 NPC

參數

Lingara-Versionheaderstring選填

回應這隻請求所用个 API 版本。無這隻个話，存取權杖會用佢个用戶端綁定个版本，無權杖个請求會用這下个版本。還在開發个版本，淨係在這位講明正用得到。無認識个版本會回 400，代碼係 api_version_unknown。GET /v1/versions 會列出所有版本。

請求內容 application/json

npcNpc必填

namestring必填

personastring | null選填

scenestring | null選填

source_langstring必填

target_langstring必填

levelinteger必填

linestring必填

historyarray of DialogueEntry選填

到今个對話，舊个先，最多 12 行。窗口由你保管：Lingara 在輪次之間麼个都毋儲存。將 NPC 每一句回答截到頭 500 隻字再送轉來。

speakerSpeaker必填

textstring必填

回應

200 角色个回答，一段一段

串流事件 text/event-stream

毋會送 keepalive 註解。

delta TurnDelta

textstring必填

notice Notice

codestring必填

messagestring必填

done Done 結束串流

error StreamError 結束串流

喺 200 回應裡肚到。狀態行已經送出去了，所以串流開始以後个失敗會用這隻事件來報告。

codestring必填

messagestring必填

plan_idstring | null選填

錯誤

402application/json

一隻按用量計費个用戶端个呼叫，在佢用忒任何東西之前就分人拒絕了。spend_cap_reached：用戶端抑係佢个帳戶已經到了每月个花費上限；請在整合頁面調高上限。metered_billing_inactive：這隻帳戶个按用量計費還毋曾啟用；請在整合頁面設定，抑係更新付款方式。

410application/json

回應這隻請求所用个 API 版本已經停用。請在 Lingara-Version 送一隻有支援个版本，或者將用戶端綁到別隻版本。

4XXapplication/json

請求分人拒絕了。code 講原因，error 用文字講明。

503application/json · text/plain

服務暫時用毋得；請等 Retry-After 裡肚个秒數過後再試。維護期間，內容係純文字，毋係錯誤封包。

5XXapplication/json

請求分人拒絕了。code 講原因，error 用文字講明。

codestring必填

請求分人拒絕个原因，係一隻穩定个代碼，做得用來分支處理：比如 insufficient_scope（403）、rate_limited（429），對按用量計費个用戶端還有 spend_cap_reached（402）㧯 metered_billing_inactive（402）。

errorstring必填

範例

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

想用函式庫？請看函式庫這一節。

串流範例

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

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

event: done
data: {}