LDPage/docs

Tìm kiếm tài liệu

GỢI Ý CHO BẠN187 kết quả

Tìm trong các bài viết · Theo từng mục

Di chuyểnMởescĐóngLDPage docs
QUẢN TRỊ HỆ THỐNGKết nối nhà cung cấp AI
Hướng dẫn từng bướcHướng dẫn quản trị

Kết nối nhà cung cấp AI

Chọn OpenAI, DeepSeek hoặc một endpoint tương thích OpenAI, nhập API key và model, lưu rồi kiểm tra kết nối, sau đó theo dõi token, chi phí và các lần gọi AI gần đây.

LDPage Team·6 phút đọc

AI Provider dùng để làm gì?#

Mọi tính năng AI của LDPage (tạo trang bằng AI, AI Agent trong trình soạn thảo, viết lại nội dung, SEO…) đều gọi tới một nhà cung cấp AI dùng chung cho toàn bộ khách hàng. Bạn khai báo nhà cung cấp này một lần ở Admin › Cài đặt › AI Provider (nhóm Tích hợp). Khách không thấy API key; mỗi lần khách dùng AI, credit AI trong gói của họ bị trừ theo số token (1 credit ≈ 1.000 token).

Chỉ chủ sở hữu hoặc nhân viên có quyền Cài đặt mới mở được trang này. Chi phí gọi AI do tài khoản API của bạn chi trả, vì vậy hãy đặt hạn mức credit AI hợp lý ở Gói dịch vụ.

1. Chọn provider, endpoint và API key#

  1. 1

    Mở menu tài khoản › Quản trị SaaS › Cài đặt, chọn AI Provider ở nhóm Tích hợp bên trái.

  2. 2

    Trong thẻ Kết nối AI, chọn Provider: OpenAI, DeepSeek hoặc OpenAI-compatible (tùy chỉnh). Chọn OpenAI hoặc DeepSeek thì Endpoint được điền sẵn (https://api.openai.com/v1 hoặc https://api.deepseek.com).

  3. 3

    OpenAI-compatible dùng cho máy chủ có API giống OpenAI như Ollama, vLLM, OpenRouter…: tự nhập Endpoint (URL gốc của API) và để trống API key nếu endpoint không cần key.

  4. 4

    Nhập API key. Khoá được lưu mã hoá trên máy chủ của bạn; sau khi lưu, ô hiện •••••••• (đã lưu — nhập để thay), để trống nếu muốn giữ key cũ. Liên kết Lấy API key mở trang lấy key của provider đang chọn.

  5. 5

    Khi đổi sang provider khác với bản đã lưu, key cũ không dùng được: form báo API key đã lưu thuộc provider trước và yêu cầu nhập key mới.

Ảnh 1. Trang AI Provider: Provider = DeepSeek, Endpoint https://api.deepseek.com, API key đã lưu và được ẩn, Model văn bản deepseek-flash với hai chip gợi ý, ô Model cho AI Agent để trống, Thời gian chờ 120 giây; bên phải thẻ Trạng thái kết nối báo Đã cấu hình (nguồn: database) và thẻ Sử dụng AI. Giao diện tiếng Việt.

2. Chọn model, đơn giá và thời gian chờ#

  1. 1

    Model văn bản: gõ tên model hoặc bấm một chip gợi ý bên dưới (OpenAI: gpt-4o-mini, gpt-4o, gpt-4.1-mini, gpt-4.1; DeepSeek: deepseek-flash, deepseek-v4-pro). Đây là model cho hầu hết tác vụ.

  2. 2

    Model cho AI Agent (tuỳ chọn): model mạnh hơn cho việc nặng của AI Agent như chế độ code hoặc viết lại nhiều phần. Bỏ trống = dùng model văn bản; việc nhẹ vẫn dùng model văn bản cho nhanh, rẻ.

  3. 3

    Đơn giá (USD/1M token): nhập giá Đầu vào và Đầu ra theo bảng giá của provider để LDPage ước tính chi phí (AI Agent hiện chi phí ước tính mỗi lượt, trang Tổng quan hiện Chi phí AI tháng này). Bỏ trống = không ước tính chi phí.

  4. 4

    Thời gian chờ: số giây tối đa chờ một lần gọi AI (5–600 giây, mặc định 120). Tăng lên nếu model chậm hoặc trang dài hay bị hết thời gian chờ.

3. Lưu cấu hình rồi kiểm tra kết nối#

  1. 1

    Bấm Lưu cấu hình ở cuối thẻ Kết nối AI.

  2. 2

    Bấm Kiểm tra kết nối. LDPage gửi một yêu cầu nhỏ tới provider bằng cấu hình ĐÃ LƯU, vì vậy hãy lưu trước khi kiểm tra; nếu chưa lưu, kết quả phản ánh cấu hình cũ.

  3. 3

    Thẻ Trạng thái kết nối bên phải hiện Đã cấu hình, Chưa cấu hình hoặc Kết nối lỗi kèm thông báo lỗi; dòng phụ ghi provider, nguồn cấu hình (database hoặc biến môi trường) và model. Thời gian phản hồi và Kiểm tra lần cuối được cập nhật sau mỗi lần kiểm tra.

  4. 4

    Sau khi kết nối thành công, thử tạo một trang bằng AI để chắc chắn mọi thứ hoạt động.

Ảnh 2. Phần dưới trang AI Provider: nút Kiểm tra kết nối và Lưu cấu hình ở cuối thẻ Kết nối AI; bảng Hoạt động gần đây liệt kê các lần gọi template_agent.* với Tokens (in/out) và Độ trễ. Ảnh chụp lúc môi trường thử còn dùng mock server nên cột Model ghi mock. Giao diện tiếng Việt.

4. Theo dõi mức sử dụng và chi phí#

  1. 1

    Thẻ Sử dụng AI cộng dồn Prompt tokens, Completion tokens và Chi phí ước tính của toàn hệ thống. Thẻ này chỉ để theo dõi vận hành; giới hạn của từng khách nằm ở hạn mức gói.

  2. 2

    Bảng Hoạt động gần đây liệt kê các lần gọi AI mới nhất: Thời gian, Thao tác (ví dụ template_agent.plan, template_agent.copy_section), Model, Tokens (in/out) và Độ trễ.

  3. 3

    Chi phí ước tính chỉ có khi bạn đã nhập Đơn giá; nếu luôn là $0.0000, hãy kiểm tra lại hai ô Đầu vào, Đầu ra.

  4. 4

    Để xem khách nào tốn chi phí AI nhất, dùng bảng Khách tốn chi phí AI nhất tháng này ở Admin › Tổng quan; để giới hạn, chỉnh Lượt AI/tháng và Credit AI/tháng trong Gói dịch vụ.

5. Cấu hình AI bằng biến môi trường#

Khi máy chủ có đặt biến môi trường AI_BASE_URL và AI_TEXT_MODEL (kèm AI_API_KEY, tuỳ chọn AI_PROVIDER, AI_AGENT_MODEL, AI_TIMEOUT_MS), cấu hình env được ưu tiên hơn màn hình: trang AI Provider hiện thông báo provider đang cấu hình qua biến môi trường và Trạng thái kết nối ghi nguồn: biến môi trường. Muốn quản lý bằng màn hình, hãy để trống AI_BASE_URL và AI_TEXT_MODEL trong tệp .env rồi khởi động lại API.

Tệp .env.example đi kèm mã nguồn điền sẵn AI_BASE_URL và AI_TEXT_MODEL của OpenAI. Nếu bạn sao chép nguyên tệp này, env sẽ ghi đè cấu hình nhập trên màn hình.

Xử lý vướng mắc#

  1. 1

    Kiểm tra kết nối báo Chưa cấu hình AI provider: chưa bấm Lưu cấu hình, hoặc chưa nhập Endpoint/Model.

  2. 2

    Kết nối lỗi do xác thực: API key sai, hết hạn hoặc thuộc provider khác; nhập lại key và lưu.

  3. 3

    Kết nối lỗi do hết thời gian chờ: tăng Thời gian chờ, kiểm tra máy chủ ra Internet được tới Endpoint, hoặc chọn model nhanh hơn.

  4. 4

    Sửa trên màn hình nhưng không có tác dụng: kiểm tra biến môi trường AI_BASE_URL/AI_TEXT_MODEL trên máy chủ (env được ưu tiên).

  5. 5

    Khách báo hết credit AI: xem hạn mức Credit AI/tháng của gói khách đang dùng hoặc gán gói cao hơn ở Admin › Khách hàng.

Kết nối nhà cung cấp AIVề đầu trang
© 2026 LDPage DocsPowered by CMSNT LTDTài liệu hướng dẫn sử dụng LDPage.