送一句話予 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: {}