Chuyển đến nội dung chính

Tổng quan

Dify hoạt động tốt với LemonData thông qua luồng nhà cung cấp mô hình tương thích với OpenAI. Đối với các phiên bản Dify hiện tại, cách an toàn nhất thường là:
  • chọn nhà cung cấp OpenAI tích hợp sẵn
  • đặt API key LemonData của bạn
  • đặt URL cơ sở tùy chỉnh là https://api.lemondata.cc/v1
Một số bản dựng Dify cũ hơn hiển thị tùy chọn này là OpenAI-API-compatible thay vì nhà cung cấp OpenAI tích hợp sẵn có trường URL cơ sở tùy chỉnh. Nếu giao diện Dify của bạn trông khác, hãy sử dụng luồng nhà cung cấp tùy chỉnh tương thích OpenAI gần nhất có sẵn trong phiên bản đó.
Loại: Framework hoặc nền tảngĐường chính: đường trò chuyện tương thích OpenAIMức hỗ trợ: Được hỗ trợ nhưng có giới hạn
Đây là một đường tích hợp thiên về chat-completions. Không nên hiểu nó như một cam kết rằng Dify sẽ có cùng hành vi Responses hoặc WebSocket như các tích hợp Codex chuyên dụng.

Điều kiện tiên quyết

  • Tài khoản LemonData có quyền truy cập API
  • Dify Cloud hoặc Dify tự lưu trữ

Các bước cấu hình

Bước 1: Lấy API Key của bạn

  1. Đăng nhập vào LemonData Dashboard
  2. Mở API Keys
  3. Tạo hoặc sao chép một API key bắt đầu bằng sk-

Bước 2: Cấu hình nhà cung cấp

1

Mở Model Providers

Trong Dify, đi đến SettingsModel Providers
2

Chọn OpenAI

Mở phần cài đặt nhà cung cấp OpenAI. Nếu phiên bản Dify của bạn không cung cấp URL cơ sở tùy chỉnh ở đây, hãy sử dụng tùy chọn nhà cung cấp tùy chỉnh tương thích OpenAI được cung cấp trong phiên bản đó.
3

Nhập cài đặt LemonData

Sử dụng các giá trị sau:
FieldValue
API Keysk-your-lemondata-key
API Base URL / Custom Base URLhttps://api.lemondata.cc/v1
4

Thêm mô hình

Thêm các mô hình bạn muốn sử dụng, ví dụ:
  • gpt-5.4
  • gpt-5-mini
  • gpt-4o
  • claude-sonnet-4-6
  • claude-opus-4-6
  • gemini-2.5-flash
  • gemini-2.5-pro
  • deepseek-r1

Bước 3: Kiểm tra kết nối

  1. Chọn một mô hình như gpt-5-mini hoặc gpt-4o
  2. Gửi một prompt kiểm tra
  3. Xác nhận rằng Dify nhận được phản hồi hợp lệ

Embeddings cho Knowledge Base

Đối với RAG và lập chỉ mục knowledge base, hãy thêm một mô hình embedding như:
  • text-embedding-3-small
  • text-embedding-3-large
Sau đó đặt mô hình đó làm mô hình embedding mặc định trong knowledge base hoặc phần cài đặt ứng dụng tương ứng.

Vai trò mô hình được khuyến nghị

Use CaseSuggested Models
Chat mặc địnhgpt-5.4, gpt-5-mini, gpt-4o
Suy luận chuyên sâugpt-5.4, claude-opus-4-6, deepseek-r1
Nhanh/rẻgpt-5-mini, gemini-2.5-flash
Embeddingstext-embedding-3-small, text-embedding-3-large

Thực tiễn tốt nhất

Trong các phiên bản Dify mới hơn, nhà cung cấp OpenAI tích hợp sẵn với URL cơ sở tùy chỉnh thường là cách thiết lập gọn gàng nhất cho LemonData.
Sử dụng gpt-5-mini hoặc gemini-2.5-flash trong khi lặp, sau đó chỉ chuyển các quy trình nặng hơn sang các mô hình mạnh hơn ở những nơi cần thiết.
Hầu hết các luồng Dify sử dụng hành vi chat tương thích OpenAI. Nếu bạn cần Responses hoặc hành vi WebSocket dành riêng cho Codex, hãy sử dụng các tích hợp Codex chuyên dụng thay vì Dify.

Khắc phục sự cố

  • Xác minh base URL chính xác là https://api.lemondata.cc/v1
  • Xóa dấu gạch chéo ở cuối nếu Dify tự động nhân đôi chúng
  • Xác nhận máy chủ Dify có thể truy cập LemonData qua internet công cộng
  • Kiểm tra lại API key
  • Xác nhận key đang hoạt động trong dashboard LemonData
  • Đảm bảo giá trị được dán vào Dify không chứa khoảng trắng hoặc xuống dòng thừa
  • Xác minh chính xác tên mô hình
  • Thêm lại mục mô hình nếu giao diện nhà cung cấp đã cache một giá trị cũ hơn
  • Kiểm tra khả dụng mô hình hiện tại trong tài liệu hoặc dashboard của LemonData