Giới thiệu

OMICX AI Assistant là trợ lý AI dạng hội thoại (chatbot) của OMICX. Đối tác bên thứ ba có thể tích hợp trực tiếp qua API để gửi tin nhắn và quản lý hội thoại thay mặt người dùng cuối của mình.

Base URL

Môi trườngHost
Devhttps://api-v1-dev.omicx.one/public-svc
Prohttps://api.omicx.one/v1

Tất cả endpoint đều yêu cầu xác thực qua header X-Api-Key — xem chi tiết tại trang Xác thực.

Hội thoại (Conversation)

Mỗi cuộc trò chuyện được nhóm theo conversation_id. Gửi tin nhắn đầu tiên không kèm conversation_id để bắt đầu hội thoại mới — response trả về conversation_id được tạo, dùng cho các tin nhắn tiếp theo trong cùng hội thoại. Mỗi hội thoại gắn với một user do đối tác tự định danh (người dùng cuối phía đối tác) — dùng để phân tách dữ liệu giữa các người dùng khác nhau.

Chế độ phản hồi (Response mode)

  • streaming (khuyên dùng) — trả kết quả dần theo dạng SSE (text/event-stream), dùng task_id để gọi Dừng khởi tạo luồng văn bản nếu cần dừng giữa chừng.
  • blocking — chờ xử lý xong, trả kết quả trong 1 response.