NPC にセリフを送る

パラメーター

Lingara-Versionheaderstring任意

このリクエストに応答する API バージョン。指定がない場合、アクセストークンはそのクライアントに固定されたバージョンを、トークンのないリクエストは現行バージョンを受け取ります。開発中のバージョンには、ここで指定した場合にのみアクセスできます。不明なバージョンにはコード api_version_unknown とともに 400 を返します。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: {}