Gửi một lượt cho gia sư
Phiên bản API 2026-10-affable-towhee
Gửi một tin nhắn đến gia sư và truyền phát câu trả lời dưới dạng các sự kiện delta, kết thúc bằng done. Không có gì được lưu lại: hãy gửi cuộc trò chuyện gần đây trong history, tối đa 20 mục. character và situation thiết lập bối cảnh. Yêu cầu gói trả phí.
Phạm vi tutor:converse
Tham số
Lingara-Versionheaderstringtùy chọn- Phiên bản API dùng để trả lời yêu cầu này. Nếu không có, token truy cập nhận phiên bản mà ứng dụng khách của nó được gắn, còn yêu cầu không có token nhận phiên bản hiện tại. Phiên bản đang phát triển chỉ có thể dùng bằng cách nêu tên nó ở đây. Phiên bản không xác định được trả lời bằng
400với mãapi_version_unknown.GET /v1/versionsliệt kê các phiên bản.
Nội dung yêu cầu application/json
messagestringbắt buộchistoryarray of TurnEntrytùy chọnroleTurnRolebắt buộccontentstringbắt buộc
source_langstringbắt buộctarget_langstringbắt buộclevelinteger | nulltùy chọncharacterstring | nulltùy chọnsituationstring | nulltùy chọn
Phản hồi
200 Câu trả lời của gia sư, từng phần một
Sự kiện luồng text/event-stream
Không gửi chú thích keepalive.
-
deltaTurnDelta -
textstringbắt buộc
-
noticeNotice -
codestringbắt buộcmessagestringbắt buộc
-
doneDone Kết thúc luồng -
errorStreamError Kết thúc luồng -
Đến bên trong phản hồi 200. Dòng trạng thái đã được gửi, nên lỗi xảy ra sau khi luồng mở được báo bằng sự kiện này.
codestringbắt buộcmessagestringbắt buộcplan_idstring | nulltùy chọn
Lỗi
402application/json- Lệnh gọi của một ứng dụng khách tính phí theo mức dùng đã bị từ chối trước khi tiêu bất cứ thứ gì.
spend_cap_reached: ứng dụng khách hoặc tài khoản của nó đã chạm hạn mức chi tiêu hằng tháng; hãy nâng hạn mức trên trang Tích hợp.metered_billing_inactive: tính phí theo mức dùng chưa được kích hoạt cho tài khoản này; hãy thiết lập hoặc cập nhật phương thức thanh toán trên trang Tích hợp. 410application/json- Phiên bản API dùng để trả lời yêu cầu này đã bị ngừng. Hãy gửi một phiên bản được hỗ trợ trong
Lingara-Version, hoặc gắn ứng dụng khách với một phiên bản khác. 4XXapplication/json- Yêu cầu đã bị từ chối.
codecho biết lý do, vàerrordiễn đạt lý do đó bằng lời. 503application/json · text/plain- Dịch vụ tạm thời không khả dụng; hãy thử lại sau số giây ghi trong
Retry-After. Trong thời gian bảo trì, phần thân là văn bản thuần thay vì phong bì lỗi. 5XXapplication/json- Yêu cầu đã bị từ chối.
codecho biết lý do, vàerrordiễn đạt lý do đó bằng lời.
codestringbắt buộcLý do yêu cầu bị từ chối, dưới dạng một mã ổn định để rẽ nhánh: ví dụ
insufficient_scope(403),rate_limited(429) và, với ứng dụng khách tính phí theo mức dùng,spend_cap_reached(402) vàmetered_billing_inactive(402).errorstringbắt buộc
Ví dụ
Muốn dùng thư viện? Xem mục Thư viện.
Luồng ví dụ
event: delta
data: {"text":"两斤荔枝,"}
event: delta
data: {"text":"一共三十块。"}
event: done
data: {}Nếu bản dịch và tài liệu tham chiếu tiếng Anh khác nhau, tài liệu tham chiếu tiếng Anh là bản đúng.