Tạo giáo án
Phiên bản API 2026-10-affable-towhee
Bắt đầu tạo giáo án và truyền phát tiến trình. started cho biết định danh của giáo án ngay khi nó tồn tại, để kết nối bị ngắt có thể kết nối lại bằng GET /v1/lesson-plans/{id}/stream. Luồng kết thúc bằng result hoặc error. Giáo án lấy từ thư viện sẽ đến dưới dạng một result duy nhất.
Phạm vi lesson_plans:write
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
contextstringbắt buộcsource_langstringbắt buộctarget_langstringbắt buộclevelintegerbắt buộc
Phản hồi
200 Tiến trình của giáo án, sau đó là giáo án
Sự kiện luồng text/event-stream
Gửi một chú thích keepalive mỗi 15 giây.
-
startedPlanStarted -
plan_idstringbắt buộc
-
phasePlanPhase -
phasestringbắt buộcattemptintegerbắt buộc
-
resultPlanResult Kết thúc luồng -
planLessonPlanbắt buộcidstringbắt buộcstatusPlanStatusbắt buộctitlestring | nulltùy chọnsource_langstringbắt buộctarget_langstringbắt buộclevelintegerbắt buộccreated_atstringbắt buộccompleted_atstring | nulltùy chọnai_generatedbooleanbắt buộccontentLessonPlanContent | nulltùy chọnintroductionstring | nulltùy chọnlearning_objectivesarray of stringbắt buộcvocabularyarray of PlanWordbắt buộcwordstringbắt buộcpronunciationstring | nulltùy chọntranslationstringbắt buộc
setsarray of PlanSetbắt buộcnumberintegerbắt buộccontextstring | nulltùy chọnquestionsarray of PlanQuestionbắt buộctypestringbắt buộcpromptstringbắt buộcoptionsarray of string | nulltùy chọnanswerstringbắt buộcexplanationstringbắt buộchintstring | nulltùy chọn
-
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: {"plan_id":"3f1c2a9e-5b7d-4e21-9a0c-6d8e4f2b1a37"}
event: phase
data: {"phase":"selecting_vocabulary","attempt":1}
event: result
data: {"plan":{"id":"3f1c2a9e-5b7d-4e21-9a0c-6d8e4f2b1a37","status":"complete","title":"At the night market","source_lang":"en","target_lang":"zh","level":2,"created_at":"2026-09-23T10:00:00Z","completed_at":"2026-09-23T10:00:41Z","ai_generated":true,"content":{"introduction":"Order food and ask prices at a night market.","learning_objectives":["Ask how much something costs"],"vocabulary":[{"word":"多少钱","pronunciation":"duōshao qián","translation":"how much"}],"sets":[{"number":1,"questions":[{"type":"multiple_choice_word","prompt":"Which word asks for a price?","options":["多少钱","谢谢"],"answer":"多少钱","explanation":"多少钱 means how much money."}]}]}}}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.