Στείλε μια φράση σε έναν NPC

Παράμετροι

Lingara-Versionheaderstringπροαιρετικό

Η έκδοση API με την οποία απαντάται αυτό το αίτημα. Χωρίς αυτήν, ένα token πρόσβασης παίρνει την έκδοση στην οποία είναι δεσμευμένος ο πελάτης του και ένα αίτημα χωρίς token παίρνει την τρέχουσα έκδοση. Η έκδοση που βρίσκεται ακόμη υπό ανάπτυξη είναι προσβάσιμη μόνο αν την ονομάσετε εδώ. Μια άγνωστη έκδοση απαντάται με 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: {}