Hantar satu ayat kepada NPC

Parameter

Lingara-Versionheaderstringpilihan

Versi API yang digunakan untuk menjawab permintaan ini. Tanpanya, token akses mendapat versi yang dipautkan kepada kliennya, dan permintaan tanpa token mendapat versi semasa. Versi yang masih dalam pembangunan hanya boleh dicapai dengan menamakannya di sini. Versi yang tidak dikenali dijawab 400 dengan kod api_version_unknown. GET /v1/versions menyenaraikan versi.

Kandungan permintaan application/json

npcNpcwajib

namestringwajib

personastring | nullpilihan

scenestring | nullpilihan

source_langstringwajib

target_langstringwajib

levelintegerwajib

linestringwajib

historyarray of DialogueEntrypilihan

Perbualan setakat ini, yang paling lama dahulu, paling banyak 12 baris. Anda yang menyimpan tetingkap: Lingara tidak menyimpan apa-apa antara giliran. Hantar semula setiap balasan NPC dengan dipotong kepada 500 aksara pertamanya.

speakerSpeakerwajib

textstringwajib

Respons

200 Balasan watak, sedikit demi sedikit

Peristiwa strim text/event-stream

Tidak menghantar komen keepalive.

delta TurnDelta

textstringwajib

notice Notice

codestringwajib

messagestringwajib

done Done Menamatkan strim

error StreamError Menamatkan strim

Tiba di dalam respons 200. Baris status telah pun dihantar, jadi kegagalan selepas strim dibuka dilaporkan sebagai peristiwa ini.

codestringwajib

messagestringwajib

plan_idstring | nullpilihan

Ralat

402application/json

Panggilan klien bermeter telah ditolak sebelum ia membelanjakan apa-apa. spend_cap_reached: klien atau akaunnya telah mencapai had perbelanjaan bulanannya; naikkan had di halaman Integrasi. metered_billing_inactive: pengebilan bermeter tidak aktif untuk akaun ini; sediakannya, atau kemas kini kaedah pembayaran, di halaman Integrasi.

410application/json

Versi API yang digunakan untuk menjawab permintaan ini telah dihentikan. Hantar versi yang disokong dalam Lingara-Version, atau pautkan klien kepada versi lain.

4XXapplication/json

Permintaan ditolak. code menyatakan sebabnya, dan error menerangkannya dengan perkataan.

503application/json · text/plain

Perkhidmatan tidak tersedia buat sementara waktu; cuba lagi selepas bilangan saat dalam Retry-After. Semasa penyelenggaraan, kandungan ialah teks biasa dan bukan sampul ralat.

5XXapplication/json

Permintaan ditolak. code menyatakan sebabnya, dan error menerangkannya dengan perkataan.

codestringwajib

Sebab permintaan ditolak, sebagai kod stabil untuk dijadikan asas percabangan: contohnya insufficient_scope (403), rate_limited (429) dan, bagi klien bermeter, spend_cap_reached (402) dan metered_billing_inactive (402).

errorstringwajib

Contoh

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

Lebih suka pustaka? Lihat bahagian Pustaka.

Contoh strim

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

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

event: done
data: {}