Nối các plugin AI của Logseq với bất kỳ model catalog nào.

Câu trả lời nhanh: ba cài đặt trong config plugin.

Cài một plugin AI từ marketplace của Logseq, mở cài đặt của nó, và điền bộ ba chuẩn: trường endpoint hoặc base URL với https://api.apisrouter.com/v1, trường API key với key APIsRouter của bạn, và trường model với một id catalog chính xác như claude-haiku-4-5-20251001. Hai ví dụ cụ thể từ hệ sinh thái. Plugin gpt3-openai lâu đời (briansunter/logseq-plugin-gpt3-openai) phơi bày một cài đặt chatCompletionEndpoint, mặc định về host của OpenAI, cộng một cài đặt model dạng văn bản tự do, nên cả hai đều chuyển hướng sạch sẽ tới một gateway. Plugin logseq-copilot mới hơn được xây cho các API tương thích OpenAI ngay từ đầu, với các cài đặt API Endpoint, API Key, và Model, và một trường model phân biệt hoa thường. Tên trường khác nhau tùy plugin; mẫu hình thì không.

API / Chat Completion Endpoint:
  https://api.apisrouter.com/v1

API Key:   sk-YOUR-APISROUTER-KEY

Model:     claude-haiku-4-5-20251001
           (case-sensitive, free text)

Cách các plugin Logseq dùng endpoint.

Logseq là công cụ outliner mã nguồn mở cho ghi chú kết nối mạng, và các plugin AI của nó móc vào editor như các lệnh slash và hành động block: tóm tắt block này, viết tiếp ở đây, trả lời từ phần đã chọn, sinh một dàn ý từ một trang. Mỗi hành động là một request chat-completions mang các block liên quan làm context, gửi tới bất kỳ endpoint nào cài đặt của plugin khai báo. Một lưu ý trung thực về hệ sinh thái, vì nó nhỏ hơn của Obsidian: các plugin AI của Logseq là các dự án cộng đồng với mức bảo trì không đều. Plugin gpt3-openai là cái được thiết lập nhất nhưng đã trải qua những khoảng lặng giữa các bản phát hành; logseq-copilot nhẹ hơn nhưng được xây có chủ đích cho các endpoint tương thích OpenAI. Kiểm tra hoạt động gần đây của một plugin trước khi phụ thuộc vào nó hàng ngày, và hãy chuẩn bị đọc bảng cài đặt của nó thay vì một trình hướng dẫn cài đặt bóng bẩy. Phía gateway là nửa ổn định của cặp đôi này. Vì endpoint nói phương ngữ chat-completions chuẩn và phục vụ mọi id catalog qua một key, một plugin đã cấu hình một lần có thể chuyển giữa một id Claude và một id DeepSeek bằng cách sửa một trường cài đặt, không cần cài lại, không cần tài khoản mới.

Chọn model cho một workflow outliner.

Việc dùng AI trong outliner mang tính bùng nổ hơn là liên tục: không có gì trong một giờ, rồi một loạt lệnh slash trong khi viết. Billing trả trước theo token phù hợp với hình dạng đó hơn bất kỳ subscription nào, và góc nhìn theo từng model của console cho thấy nhịp độ thực tế của bạn tốn bao nhiêu trên mỗi id.

• claude-haiku-4-5-20251001 làm bộ điều khiển hàng ngày: tóm tắt block, viết lại nhanh, và câu trả lời có căn cứ trên một trang context.
• claude-sonnet-4-6 cho tổng hợp nặng hơn, soạn thảo các phần dài từ một dàn ý, hoặc bất cứ gì bạn sẽ xuất bản.
• gpt-5.4-mini làm lựa chọn khối lượng họ GPT nếu prompt của bạn được định hình theo hành vi OpenAI.
• deepseek-v4-flash cho các lượt hàng loạt, như tóm tắt mọi trang nhật ký trong một tháng, ở mức giá sàn.
• glm-5 đáng thử cho các graph song ngữ, đặc biệt ghi chú pha trộn Trung-Anh.

Trả theo mức sử dụng · thấp hơn giá chính thức

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

Các kiểu lỗi đặc thù của plugin Logseq.

Phân công khi debug: curl chứng minh endpoint, key, và id trong hai lệnh, và mọi thứ còn lại là cấu hình hoặc tính tương thích của plugin. Thứ tự đó tiết kiệm nhiều thời gian nhất trong một hệ sinh thái plugin nơi lớp công cụ là phần dễ biến động.

• Lệnh âm thầm không làm gì: mở cài đặt của plugin và xác nhận trường endpoint thực sự đã lưu; một số plugin yêu cầu tắt rồi bật lại plugin sau khi đổi cài đặt.
• Lỗi model với thông báo not-found: trường model phân biệt hoa thường ở ít nhất một plugin phổ biến, và id phải khớp chính xác danh sách catalog. Copy từ /v1/models, không copy từ trí nhớ.
• Trường endpoint mong đợi một độ sâu đường dẫn khác: hầu hết plugin muốn base kết thúc bằng /v1 và tự nối thêm route; nếu một cái đòi hỏi đường dẫn đầy đủ, hãy đưa nó /v1/chat/completions tường minh và ghi nhớ plugin của bạn dùng kiểu nào.
• Lỗi 401: trường key chứa khoảng trắng hoặc một key cũ. Curl danh sách model với cùng key để xác nhận bên ngoài Logseq.
• Plugin hỏng sau một bản cập nhật Logseq: các plugin cộng đồng đôi khi chậm hơn các bản phát hành app. Kiểm tra các issue của repository plugin trước khi giả định endpoint đã đổi; kiểm tra curl chứng minh nửa gateway trong vài giây.

Ai định tuyến Logseq qua một gateway.

• Người viết nhật ký hàng ngày chạy tóm tắt và viết lại trên graph của họ bằng một id tầng khối lượng.
• Người viết soạn thảo từ dàn ý muốn một id chủ lực sẵn sàng cho các đoạn văn quan trọng.
• Người ghi chú song ngữ thử nghiệm id GLM và DeepSeek đối chiếu với Claude trên các block đa ngôn ngữ.
• Người dùng chú trọng riêng tư đã chọn Logseq vì file cục bộ và muốn traffic AI của họ tập trung sau một key có thể kiểm toán.
• Người đã định tuyến editor hoặc terminal qua một gateway muốn ghi chú trên cùng số dư và log sử dụng.

Xác minh endpoint, rồi thử một block.

Chạy kiểm tra hai lệnh với đúng id model bạn đã cấu hình, rồi kích hoạt một lệnh slash trên một block nhỏ. Nếu curl qua mà plugin thất bại, vấn đề là cài đặt hoặc phiên bản của plugin, và repository của nó là nơi đúng để tìm. Khi các lệnh chảy qua, console APIsRouter ghi lại model, token, và chi tiêu theo từng request. Khối lượng công việc ghi chú nhẹ hơn so với các agent coding, nên hầu hết người dùng Logseq thấy console chủ yếu xác nhận hóa đơn nhỏ; giá trị nằm ở việc biết điều đó từ dữ liệu thay vì hy vọng.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-4-5-20251001",
       "messages":[{"role":"user","content":"Summarize: spaced repetition beats cramming."}]}'

Câu hỏi thường gặp