BroadRouter

Dùng Cline với BroadNet Inference (provider OpenAI Compatible)

Cập nhật

Trong cài đặt Cline, chọn API Provider là OpenAI Compatible, Base URL là https://inference.broadnet.ai/v1, API Key là key BroadNet và Model là một ID BroadNet như broadnet/glm-5.3 hoặc broadnet/deepseek-v4.1-flash. Sau đó nhập context window trong Model Configuration để Cline biết được gửi bao nhiêu.

Cline là một coding agent chạy trong VS Code. Nó kết nối với bất kỳ API tương thích OpenAI nào qua provider OpenAI Compatible, và BroadNet Inference dùng cấu trúc chat completions chuẩn tại https://inference.broadnet.ai/v1. Các bước dưới đây làm theo tài liệu provider của chính Cline. Nếu bạn thích agent chạy trong terminal, hãy xem hướng dẫn Aider.

Thiết lập

  1. Lấy key. Tạo một key trả theo mức dùng trong console BroadNet, hoặc mua một gói không giới hạn và dùng key của gói.

  2. Mở cài đặt Cline. Bấm biểu tượng bánh răng trong bảng Cline.

  3. Chọn provider. Trong danh sách API Provider, chọn OpenAI Compatible.

  4. Điền các trường kết nối.

    Trường Giá trị
    Base URL https://inference.broadnet.ai/v1
    API Key key BroadNet của bạn
    Model broadnet/glm-5.3 (hoặc một ID khác trong bảng dưới)
  5. Đặt Model Configuration. Mở Model Configuration và nhập context window của model bạn chọn. Đặt Max Output Tokens đủ cao để chừa chỗ cho suy luận; vài nghìn token là mức khởi đầu an toàn. Chỉ bật hỗ trợ hình ảnh với model nhận hình ảnh. Bạn cũng có thể nhập giá đầu vào và đầu ra từ trang giá để chi phí Cline hiển thị sát với hóa đơn.

  6. Chạy thử. Bắt đầu một task nhỏ, như “explain this file”. Nếu có câu trả lời, kết nối đã hoạt động.

Hãy gõ model ID chính xác, kể cả tiền tố broadnet/.

Chọn model nào

Model ID Context Phù hợp cho
GLM 5.3 broadnet/glm-5.3 1.048.576 Việc của agent phụ thuộc vào gọi tool
DeepSeek V4.1 Flash broadnet/deepseek-v4.1-flash 1.048.576 Phiên dài trên gói không giới hạn; văn bản và hình ảnh
Qwen3.8 27B broadnet/qwen3.8-27b 262.144 Tool kèm hình ảnh; văn bản tiếng Ả Rập
BroadNet Gemma 4 VL 26B broadnet/gemma-4-26b-a4b 32.768 Thử thiết lập bằng tín dụng miễn phí

Tài liệu BroadNet ghi hỗ trợ tool và đầu ra có cấu trúc cho GLM 5.3 và Qwen3.8 27B. Tài liệu không ghi gọi tool cho DeepSeek V4.1 Flash, nên hãy chạy một task thật ngắn trên model này trước khi cam kết một tháng. Một giờ Meteor giá $1, một tháng Full Moon giá $60; cả hai có trên trang gói. Xem chi tiết trên trang model DeepSeek V4.1 Flash.

Xử lý sự cố

  • 401 Unauthorized. Key bị thiếu, sai hoặc đã hết hạn, hoặc tài khoản trả theo mức dùng đã hết hạn mức. Dán lại key và kiểm tra số dư. Tài liệu Cline khuyên xác nhận key thuộc về đúng nhà cung cấp ở Base URL.
  • Không tìm thấy model hoặc request đầu tiên thất bại. Kiểm tra ID. Nó phải khớp chính xác với model ID của BroadNet. Các model trả phí cần nạp tiền; trong các model chat, chỉ broadnet/gemma-4-26b-a4b dùng được với $5 tín dụng miễn phí.
  • Câu trả lời rỗng hoặc dừng sớm. Suy luận được tính vào giới hạn đầu ra. Hãy tăng Max Output Tokens. Vì sao câu trả lời trả về rỗng.
  • 429 Too Many Requests. Một key trả theo mức dùng cho phép 30 request mỗi phút và 4 request đang xử lý cùng lúc. Cline gửi từng request nối tiếp nhau, nên lỗi này thường có nghĩa là một ứng dụng khác đang dùng chung key. Xem lỗi và thử lại.
  • Phản hồi chậm khi mở nhiều cửa sổ Cline. Một phiên của gói chạy một request tại một thời điểm. Hai task Cline cùng lúc trên một phiên sẽ phải chờ nhau. Hãy mua mỗi task song song một phiên, hoặc đọc chạy song song coding agent với giá cố định.
  • Lỗi kết nối. Kiểm tra Base URL kết thúc bằng /v1 và mạng của bạn cho phép HTTPS đi ra ngoài. Nếu key có danh sách IP cho phép, hãy thêm địa chỉ máy của bạn.

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

Vì sao Cline trả về phản hồi rỗng?

Model đã tiêu hết ngân sách đầu ra cho suy luận trước khi viết câu trả lời. DeepSeek V4.1 Flash, GLM 5.3 và Qwen3.8 27B suy luận trước, và suy luận được tính vào max_tokens. Hãy tăng Max Output Tokens trong Model Configuration.

Có chạy Cline bằng gói không giới hạn được không?

Có. Các gói không giới hạn dùng DeepSeek V4.1 Flash, model ID broadnet/deepseek-v4.1-flash. Dùng key của gói làm API Key. Mỗi task của Cline dùng một phiên của gói.

Vì sao danh sách model không tự hiện ra?

Hãy gõ model ID vào trường Model. Tài liệu BroadNet mô tả GET /v1/models là metadata danh mục công khai dành cho công cụ giám sát, nên đừng trông vào nó để điền danh sách chọn model.

Model BroadNet nào dùng được với tín dụng ban đầu miễn phí?

Trong các model chat, chỉ có BroadNet Gemma 4 VL 26B, model ID broadnet/gemma-4-26b-a4b; tín dụng này cũng dùng được cho hai model Transcribe. Các model chat khác cần nạp tiền. Context 32.768 token của nó khá nhỏ cho repository lớn.

Đọc dạng MarkdownHỏi ChatGPTHỏi ClaudeHỏi Perplexity