Tài liệu

Cline

Nhà cung cấp OpenAI Compatible của Cline yêu cầu URL cơ sở, khóa và ID mô hình. Các trường giá bên dưới được dùng để tính chi phí từng tác vụ đang chạy, vì vậy nên điền chính xác.

Nhà cung cấp OpenAI Compatible của Cline nhận base URL, key và model id, cùng giá từng model để hiển thị chi phí phiên đang chạy.

Cài đặt Cline ⚙︎

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...
Model ID       claude-sonnet-5

Model Configuration
  Context Window     200000
  Max Output Tokens  64000
  Image Support      on
  Input Price        (from the table below)
  Output Price       (from the table below)

Cline hiển thị chi phí đang chạy trong khi thực hiện một tác vụ và tính con số đó dựa trên Input Price và Output Price trong khối cấu hình mô hình — ứng dụng không đọc mức giá từ điểm cuối. Nếu giữ nguyên các giá trị mặc định, con số hiển thị sẽ sai theo hướng mà các giá trị mặc định đang quy định.

Giữ /v1 trong URL cơ sở. Cline chỉ thêm đường dẫn, vì vậy https://api.kunavo.com sẽ trả về 404 còn https://api.kunavo.com/v1 sẽ phân giải được. Nếu nhận 401 thì URL đúng nhưng khóa không đúng.

Chưa có khóa? Tạo tài khoản Kunavo, tạo khóa (bắt đầu bằng sk-kn-) và nạp tín dụng từ $10 — các lệnh gọi được thanh toán từ số dư đó và các lệnh gọi thất bại không bị tính phí. Sau đó, bảng điều khiển mở tại phần thiết lập Cline.

Từng bước

Tạo khóa tại /app/keys rồi sao chép khóa — khóa chỉ hiển thị một lần.
Mở bảng cài đặt Cline (biểu tượng ⚙︎) rồi chọn OpenAI Compatible làm API Provider.
Nhập Base URL, API Key và Model ID.
Mở rộng Model Configuration rồi đặt cửa sổ ngữ cảnh, số token đầu ra tối đa, khả năng hỗ trợ hình ảnh và cả hai mức giá.
Bắt đầu một tác vụ. Plan và Act có thể dùng các mô hình khác nhau, vì vậy hãy ghép một mô hình lập kế hoạch với một mô hình thực thi rẻ hơn thay vì trả mức giá lập kế hoạch cho mọi chỉnh sửa.

Đã kiểm tra đối chiếu với trang nhà cung cấp OpenAI Compatible của Cline vào 6 tháng 9, 2026. Cài đặt của bên thứ ba có thể thay đổi; nếu tên trường ở đây không còn khớp với những gì bạn thấy, trang đó là nguồn có thẩm quyền, không phải trang này.

Đây là phiên bản ngắn. Hướng dẫn đầy đủ — lựa chọn mô hình, chi phí của một phiên thực tế và các trường hợp lỗi — nằm trong hướng dẫn từng bước Cline + Claude.

Xác minh trước khi gỡ lỗi ứng dụng khách

Một yêu cầu sẽ xác định liệu lỗi nằm ở endpoint, khóa hay tệp cấu hình. Nếu lệnh này trả về JSON, cùng base URL và khóa sẽ hoạt động trong Cline.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Đặt model id nào vào trường

Mọi mô hình văn bản đều có thể truy cập bằng model id — danh sách đang hoạt động là GET /v1/models, còn danh mục kèm giá nằm trên trang mô hình. Mức giá tính bằng USD trên mỗi 1M token, đầu vào / đầu ra.

ID mô hình	Kunavo vào / ra	Phù hợp ở đâu trong Cline
`claude-sonnet-5`	$1.40 / $7.00	chế độ Act — mô hình mặc định để làm việc
`claude-opus-5`	$3.50 / $17.50	chế độ Plan, nơi chi phí của phần còn lại tác vụ phụ thuộc vào kế hoạch
`claude-haiku-4-5`	$0.70 / $3.50	đọc rẻ và kiểm tra tệp lặp lại
`gpt-5-6-terra`	$0.70 / $4.20	một họ mô hình khác dùng cùng khóa để có thêm ý kiến

Thanh toán theo token từ số dư trả trước, không có phí hàng tháng — xem trang Thanh toán. Với ngữ cảnh lặp lại — chiếm phần lớn dữ liệu mà trình chỉnh sửa hoặc ứng dụng trò chuyện gửi đi — bộ nhớ đệm prompt ảnh hưởng đến hóa đơn nhiều hơn lựa chọn mô hình.

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

Làm cách nào để dùng Cline với API tùy chỉnh tương thích OpenAI?

Trong bảng cài đặt Cline, chọn "OpenAI Compatible" làm API Provider, rồi nhập Base URL của điểm cuối, API Key và Model ID bạn muốn dùng. URL cơ sở phải là gốc /v1 vì Cline chỉ thêm đường dẫn vào đó. Sau đó, Cline giao tiếp với điểm cuối bằng định dạng truyền tải OpenAI, bất kể nhà cung cấp nào thực sự cung cấp mô hình.

Cline có thể dùng mô hình Claude mà không cần khóa API Anthropic không?

Có, nếu mô hình được cung cấp qua một điểm cuối tương thích OpenAI. Cline chuyển nguyên ID mô hình, nên điểm cuối sẽ phân giải ID Claude thay vì tiện ích mở rộng; Cline chỉ lưu thông tin xác thực của điểm cuối. Nhờ vậy, một khóa có thể dùng cho cả ID Claude lẫn GPT trong cùng mục nhà cung cấp.

Vì sao ước tính chi phí của Cline không chính xác?

Vì Cline tính chi phí từ các trường Input Price và Output Price trong khối cấu hình model. Các trường này được nhập thủ công, không được lấy từ endpoint. Nếu chúng vẫn để giá trị mặc định hoặc được sao chép từ một nhà cung cấp khác, mọi thông tin hiển thị về chi phí đều sẽ kế thừa sai lệch đó. Hãy điền mức giá endpoint thực sự tính cho model id bạn đã chọn.

URL cơ sở của Cline có cần kết thúc bằng /v1 không?

Có, nếu dùng endpoint tương thích với OpenAI. Cline nối route — /chat/completions — vào URL cơ sở bạn cung cấp, vì vậy https://api.example.com/v1 sẽ phân giải đúng, còn https://api.example.com gửi yêu cầu đến một đường dẫn không tồn tại. Lỗi 404 thường chỉ ra URL cơ sở; lỗi 401 chỉ ra khóa.