Bir NPC'ye bir replik gönder

Parametreler

Lingara-Versionheaderstringisteğe bağlı

Bu isteğin yanıtlanacağı API sürümü. Belirtilmezse bir erişim token'ı istemcisinin bağlı olduğu sürümü, token içermeyen bir istek ise güncel sürümü alır. Hâlâ geliştirilmekte olan sürüme yalnızca burada adı verilerek ulaşılır. Bilinmeyen bir sürüm 400 ve api_version_unknown koduyla yanıtlanır. GET /v1/versions sürümleri listeler.

İstek gövdesi application/json

npcNpczorunlu

namestringzorunlu

personastring | nullisteğe bağlı

scenestring | nullisteğe bağlı

source_langstringzorunlu

target_langstringzorunlu

levelintegerzorunlu

linestringzorunlu

historyarray of DialogueEntryisteğe bağlı

Şimdiye kadarki konuşma, en eskisi önce, en fazla 12 satır. Pencereyi siz tutarsınız: Lingara turlar arasında hiçbir şey saklamaz. Her NPC yanıtını ilk 500 karakterine kısaltarak geri gönderin.

speakerSpeakerzorunlu

textstringzorunlu

Yanıtlar

200 Karakterin yanıtı, parça parça

Akış olayları text/event-stream

Keepalive yorumu göndermez.

delta TurnDelta

textstringzorunlu

notice Notice

codestringzorunlu

messagestringzorunlu

done Done Akışı sonlandırır

error StreamError Akışı sonlandırır

200 yanıtının içinde gelir. Durum satırı zaten gönderilmiş olduğundan, akış açıldıktan sonraki bir hata bu olay olarak bildirilir.

codestringzorunlu

messagestringzorunlu

plan_idstring | nullisteğe bağlı

Hatalar

402application/json

Kullanım başına ücretlendirilen bir istemcinin çağrısı, hiçbir şey harcamadan reddedildi. spend_cap_reached: istemci veya hesabı aylık harcama sınırına ulaştı; sınırı Entegrasyonlar sayfasında yükseltin. metered_billing_inactive: bu hesap için kullanım başına ücretlendirme etkin değil; Entegrasyonlar sayfasında kurun veya ödeme yöntemini güncelleyin.

410application/json

Bu isteğin yanıtlandığı API sürümü sonlandırıldı. Lingara-Version içinde desteklenen bir sürüm gönderin veya istemciyi başka bir sürüme bağlayın.

4XXapplication/json

İstek reddedildi. code nedenini belirtir, error ise bunu sözcüklerle açıklar.

503application/json · text/plain

Hizmet geçici olarak kullanılamıyor; Retry-After içindeki saniye sayısı kadar bekledikten sonra yeniden deneyin. Bakım sırasında gövde, hata zarfı yerine düz metindir.

5XXapplication/json

İstek reddedildi. code nedenini belirtir, error ise bunu sözcüklerle açıklar.

codestringzorunlu

İsteğin neden reddedildiği, dallanmak için kullanılabilecek sabit bir kod olarak: örneğin insufficient_scope (403), rate_limited (429) ve kullanım başına ücretlendirilen bir istemci için spend_cap_reached (402) ile metered_billing_inactive (402).

errorstringzorunlu

Örnek

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

Kütüphane mi tercih edersiniz? Kütüphaneler bölümüne bakın.

Örnek akış

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

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

event: done
data: {}