Tạo danh sách từ vựng
Phiên bản API 2026-10-affable-towhee
Truyền phát danh sách từ ở trình độ được yêu cầu. Luồng gửi started kèm thông tin chi tiết của danh sách, một sự kiện item cho mỗi từ, rồi done. Cho đến khi danh sách sẵn sàng, luồng chỉ gửi các chú thích keepalive.
Phạm vi vocab:generate
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
levelintegerbắt buộcsource_langstringbắt buộctarget_langstringbắt buộccountinteger | nulltùy chọn
Phản hồi
200 Danh sách, mỗi sự kiện một từ
Sự kiện luồng text/event-stream
Gửi một chú thích keepalive mỗi 15 giây.
-
startedVocabStarted -
metaVocabMetabắt buộclevelintegerbắt buộcsource_langstringbắt buộctarget_langstringbắt buộcframeworkstringbắt buộccountintegerbắt buộcai_generatedbooleanbắt buộc
-
itemVocabItem -
wordstringbắt buộcpronunciationstring | nulltùy chọnreadingstring | nulltùy chọntranslationstringbắt buộcexampleVocabExample | nulltùy chọnsentencestringbắt buộctranslationstringbắt buộc
image_urlstring | nulltùy chọn
-
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: started
data: {"meta":{"level":2,"source_lang":"en","target_lang":"zh","framework":"HSK","count":2,"ai_generated":true}}
event: item
data: {"word":"你好","pronunciation":"nǐ hǎo","translation":"hello","example":{"sentence":"你好,我叫小明。","translation":"Hello, my name is Xiaoming."}}
event: item
data: {"word":"谢谢","pronunciation":"xiè xie","translation":"thank you"}
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.