Hướng dẫn API Truy xuất Kiến thức

Endpoint Yêu cầu

POST /external/use/seek-knowledge/seek HTTP/1.1

Yêu cầu Danh sách Mô hình Khả dụng

GET /external/use/seek-knowledge/models HTTP/1.1

Request Headers

HeaderGiá trịMô tả
AuthorizationBearer <your_token>Token xác thực để xác minh danh tính người dùng. Thay <your_token> bằng token thực của bạn.
Content-Typeapplication/jsonCho biết request body ở định dạng JSON.
Hostedge.flowith.netĐịa chỉ máy chủ API.
User-AgentHTTPie(Tùy chọn) Định danh client.

Request Body (JSON)

Tham sốKiểuMô tả
messagesArrayDanh sách tin nhắn hội thoại. Mỗi đối tượng tin nhắn chứa các trường role và content.
modelStringTên mô hình. Ví dụ: "gpt-4o-mini"
streamBooleanBật phản hồi dạng stream? true để bật, false để tắt.
kb_listString ArrayDanh sách ID knowledge base. Chỉ định phạm vi cho việc truy xuất kiến thức.

Chi tiết Trường messages

  • role: Vai trò của tin nhắn, có thể là "assistant" hoặc "user".
  • content: Nội dung tin nhắn, chẳng hạn như các truy vấn hoặc chỉ dẫn phức tạp.

Phản hồi

Khi stream là true (Phản hồi dạng Stream)

  • Mã Trạng thái Phản hồi: 200 OK
  • Response Headers: Bao gồm các HTTP header tiêu chuẩn như Content-Type: text/plain; charset=UTF-8, v.v.
  • Response Body: Luồng văn bản bắt đầu bằng data:. Mỗi khối data: chứa một đối tượng JSON với các giá trị tag có thể có sau đây:
    • searching: Cho biết việc tìm kiếm đang diễn ra, trường content bao gồm các cập nhật tiến trình.
    • seeds: Kết quả tìm kiếm trung gian, content là một mảng JSON trong đó mỗi phần tử là một mẩu kiến thức riêng biệt chứa id, tokens, content, order, source_id, source_title, và nip.
    • final: Cho biết kết quả cuối cùng, content chứa toàn bộ văn bản phản hồi.

Khi stream là false

  • Mã Trạng thái Phản hồi: 200 OK
  • Response Headers: Bao gồm các HTTP header tiêu chuẩn như Content-Type: application/json, v.v.
  • Response Body: Một đối tượng JSON chứa các trường tag và content.
    • tag: Luôn là "final".
    • content: Toàn bộ văn bản phản hồi.

Ví dụ curl

Phản hồi dạng Stream (stream = true)

curl -X POST "https://edge.flowith.net/external/use/knowledge-base/seek" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json" \
  -H "Host: edge.flowith.net" \
  -d '{
    "messages": [
      {"role": "assistant", "content": "I'd like to explore effective social dynamics and interpersonal relationships"},
      {"role": "user", "content": "Share your best strategies for authentic connection and building rapport in professional settings"}
    ],
    "model": "gpt-4.1-mini",
    "stream": true,
    "kb_list": ["<knowledge_base_id>"]
  }'

Phản hồi không Stream (stream = false)

curl -X POST "https://edge.flowith.net/external/use/knowledge-base/seek" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json" \
  -H "Host: edge.flowith.net" \
  -d '{
    "messages": [
      {"role": "assistant", "content": "I'd like to explore effective social dynamics and interpersonal relationships"},
      {"role": "user", "content": "Share your best strategies for authentic connection and building rapport in professional settings"}
    ],
    "model": "gpt-4.1-mini",
    "stream": false,
    "kb_list": ["<knowledge_base_id>"]
  }'

Hãy nhớ thay <your_token> và <knowledge_base_id> bằng các giá trị thực của bạn.

Giới hạn Tần suất

  • Yêu cầu: 12 yêu cầu mỗi phút (RPM)
  • Lưu ý: Vượt quá giới hạn này sẽ dẫn đến lỗi HTTP 429 (Too Many Requests)

Tính phí

  • Sử dụng Hạn mức: Chi phí được tính dựa trên hạn mức Credits của tài khoản Flowith tương ứng
  • Chu kỳ Tính phí: Mức sử dụng được tính và trừ theo thời gian thực từ số dư tài khoản của bạn