Nếu bạn đang thiết lập nhà cung cấp API tương thích Cline OpenAI, các trường hiển thị rất đơn giản: Base URL, API key và model ID. Rủi ro trong môi trường production thì khó thấy hơn. Một đường dẫn sai, bí danh model cũ, khả năng của model chưa được kiểm tra hoặc một key không sở hữu có thể khiến Cline gặp lỗi chỉ sau khi nhà phát triển bắt đầu phụ thuộc vào nó trong VS Code.
Hướng dẫn này trình bày một cách thiết lập Flatkey thực tế cho các nhà phát triển, đội ngũ sản phẩm AI, người xây dựng tự động hóa, kỹ sư nền tảng, người vận hành tài chính và người đánh giá mua sắm muốn Cline sử dụng một tuyến Flatkey tương thích OpenAI thay vì các thông tin xác thực riêng biệt cho từng nhà cung cấp model. Nó bao gồm các trường của Cline, kiểm tra Base URL của Flatkey, một bài kiểm tra curl sơ bộ, xác minh, các chế độ lỗi và việc bàn giao sử dụng.
Lưu ý nguồn: thông tin này đã được kiểm tra vào ngày 29 tháng 6 năm 2026 dựa trên tài liệu chính thức về nhà cung cấp Tương thích Cline OpenAI, tài liệu chính thức về cấu hình quản trị Tương thích Cline OpenAI và các trang công khai đang hoạt động của Flatkey. Không có key Flatkey dành riêng cho tài khoản hoặc không gian làm việc Cline nào để thực hiện kiểm tra sơ bộ (smoke test) trực tiếp, vì vậy các đoạn mã yêu cầu dưới đây là các mẫu để bạn chạy với key và bí danh model của riêng mình.
Trả lời nhanh: Thiết lập API tương thích Cline OpenAI
Để thiết lập API tương thích Cline OpenAI với Flatkey, hãy chọn OpenAI Compatible làm nhà cung cấp API Cline, sử dụng Base URL hiện tại của Flatkey, dán một API key của Flatkey và nhập chính xác bí danh model của Flatkey làm model ID. Sau đó, hãy xác minh bằng một prompt nhỏ trước khi bạn bật cấu hình model nâng cao hơn.
| Trường Cline | Giá trị Flatkey | Kiểm tra đánh giá |
|---|---|---|
| Nhà cung cấp API | OpenAI Compatible | Sử dụng nhà cung cấp này cho Flatkey, không phải nhà cung cấp OpenAI chính thức, vì Flatkey là điểm cuối tương thích. |
| Base URL | https://console.flatkey.ai/v1 khi đây là giá trị hiện tại được hiển thị cho tài khoản Flatkey của bạn |
Sử dụng Base URL, không phải đường dẫn đầy đủ /chat/completions. Sao chép giá trị trực tiếp từ Flatkey trước khi đưa vào môi trường production. |
| API Key | Một key Flatkey thuộc sở hữu của nhà phát triển, đội ngũ hoặc môi trường | Không dán các key của nhà cung cấp ngược dòng vào Cline nếu Flatkey được dự định là cổng kết nối. |
| Model | Bí danh model Flatkey chính xác đã được bật cho tài khoản đó | Tên model là đặc thù của từng nhà cung cấp. Sử dụng bí danh mà Flatkey mong đợi, không phải tên họ nhà cung cấp chung chung. |
| Cấu hình Model | Các cài đặt về ngữ cảnh, token đầu ra, hình ảnh, sử dụng máy tính và giá chỉ sau khi trò chuyện cơ bản hoạt động | Không đánh dấu các khả năng là có sẵn cho đến khi tuyến Flatkey và bí danh model đã chọn được kiểm tra. |
Đó là con đường ngắn gọn. Phần còn lại của hướng dẫn API tương thích Cline OpenAI này là về việc làm cho việc thiết lập có thể lặp lại đủ cho các đội ngũ: trước tiên chứng minh việc truyền tải, sau đó chứng minh bí danh model, rồi ghi lại tài liệu về tuyến đường mà các chủ sở hữu tài chính và nền tảng sẽ xem xét.
Những gì tài liệu Cline hiện tại xác nhận
Trang chính thức về nhà cung cấp Tương thích Cline OpenAI cho biết Cline hỗ trợ các nhà cung cấp có API tương thích với tiêu chuẩn API của OpenAI, bao gồm các model cục bộ, nhà cung cấp đám mây và bất kỳ điểm cuối nào khác tương thích với OpenAI. Trang này cũng nói rằng trang Tương thích OpenAI dành cho các nhà cung cấp khác ngoài API OpenAI chính thức, vốn có trang cấu hình riêng.
Đối với việc tích hợp này, các trường quan trọng của Cline rất đơn giản. Cline ghi nhận Base URL, API Key và Model ID là các cài đặt chính. Trong bảng cài đặt của Cline, quy trình được ghi nhận là chọn OpenAI Compatible, nhập Base URL của nhà cung cấp, nhập API key và chọn hoặc nhập model ID. Cùng trang đó liệt kê các trường cấu hình model nâng cao như số token đầu ra tối đa, kích thước cửa sổ ngữ cảnh, hỗ trợ hình ảnh, sử dụng máy tính, giá đầu vào và giá đầu ra.
Phần khắc phục sự cố chính thức cũng hữu ích cho việc thiết lập Flatkey. Cline chỉ ra các lỗi như API key không hợp lệ, không tìm thấy model, lỗi kết nối và kết quả không mong muốn. Đó cũng là bốn lỗi đầu tiên cần phân biệt khi một tuyến API tương thích Cline OpenAI bị lỗi thông qua một cổng kết nối.
Các giá trị Flatkey cần xác nhận trước khi mở Cline
Thực hiện các kiểm tra này trước khi bạn dán bất cứ thứ gì vào Cline. Chúng giữ cho việc thiết lập gắn liền với trạng thái tài khoản Flatkey hiện tại thay vì một ví dụ được sao chép.
1. Xác nhận Base URL hiện tại của Flatkey
Trang chủ của Flatkey được kiểm tra vào ngày 29 tháng 6 năm 2026 có tiêu đề One API gateway for production AI teams và mô tả meta nói rằng Flatkey hợp nhất quyền truy cập model, định tuyến, thanh toán, phân tích sử dụng và kiểm soát vận hành. Cùng trang công khai đó hiển thị các ví dụ theo kiểu OpenAI sử dụng https://console.flatkey.ai/v1 và https://console.flatkey.ai/v1/chat/completions.
Đối với Cline, hãy sử dụng giá trị Base URL trong trường Base URL. Không dán URL chat-completions đầy đủ vào Cline. Nếu giá trị trên bảng điều khiển Flatkey trong tương lai khác đi, hãy sử dụng giá trị được Flatkey hiển thị cho tài khoản của bạn và lưu giữ giá trị đang hoạt động trong sổ tay vận hành (runbook) của bạn.
2. Xác nhận bí danh model và họ điểm cuối
Trang giá của Flatkey được kiểm tra vào ngày 29 tháng 6 năm 2026 cho biết họ công bố giá được hiển thị phía máy chủ cho 635 mô hình AI từ 23 nhà cung cấp. Bản đồ điểm cuối của nó bao gồm /v1/chat/completions, /v1/responses, /v1/messages, /v1/images/generations, và /v1/video/generations.
Sử dụng những thông tin này như bằng chứng công khai có ghi ngày tháng về hình dạng danh mục, không phải là sự đảm bảo rằng khóa Flatkey của bạn có thể gọi mọi mô hình hoặc điểm cuối. Đối với nhà cung cấp API tương thích Cline OpenAI, hãy chọn một bí danh mô hình hỗ trợ đường dẫn trò chuyện tương thích OpenAI và bộ khả năng mong đợi của Cline.
3. Xác nhận ai sở hữu khóa
Cline hoạt động trong quy trình làm việc của nhà phát triển, vì vậy việc sử dụng khóa cá nhân rất hấp dẫn. Đối với một tuyến đường dành cho nhóm sản xuất, hãy sử dụng khóa Flatkey thuộc sở hữu của người dùng, nhóm hoặc môi trường phù hợp. Ghi lại ai có thể xoay vòng khóa, khóa đó nên tiếp cận những bí danh mô hình nào và người dùng hoặc tổ chức Cline nào phụ thuộc vào nó.
Từng bước: cấu hình Cline với Flatkey
- Mở cài đặt Cline. Trong tiện ích mở rộng Cline, mở bảng cài đặt từ biểu tượng bánh răng.
- Chọn OpenAI Compatible. Trong API Provider, chọn OpenAI Compatible. Đây là loại nhà cung cấp Cline cho một tuyến đường tương thích Flatkey OpenAI.
- Đặt Base URL. Nhập URL cơ sở Flatkey hiện tại, ví dụ
https://console.flatkey.ai/v1khi đó là giá trị được hiển thị cho tài khoản của bạn. - Dán khóa API Flatkey. Sử dụng khóa Flatkey cho người dùng, nhóm hoặc môi trường. Giữ nó ngoài các lời nhắc, tệp repo, bình luận vấn đề và ảnh chụp màn hình.
- Đặt Model. Nhập chính xác bí danh mô hình Flatkey. Nếu Cline hiển thị một bộ chọn, vẫn phải xác minh rằng bí danh đã chọn được phê duyệt cho khối lượng công việc này.
- Giữ cấu hình mô hình nâng cao ở mức thận trọng. Bắt đầu với giá trị token đầu ra tối đa nhỏ và cửa sổ ngữ cảnh đã biết. Chỉ bật hỗ trợ hình ảnh hoặc các cờ khả năng kiểu sử dụng máy tính sau khi tuyến đường đã chọn chứng minh được chúng.
- Xác minh kết nối. Sử dụng luồng xác minh của Cline nếu có, sau đó chạy một lời nhắc Cline nhỏ không chạm vào mã sản xuất hoặc bí mật.
- Kiểm tra khả năng hiển thị sử dụng Flatkey. Sau một lời nhắc Cline thành công, hãy xem lại việc sử dụng Flatkey cho khóa, bí danh mô hình và dấu thời gian. Đây là điểm bàn giao cho những người đánh giá tài chính và nền tảng.
- Ghi lại phương án khôi phục. Ghi lại các cài đặt nhà cung cấp Cline trước đó hoặc bí danh mô hình hoạt động trước đó trước khi yêu cầu thêm các nhà phát triển khác chuyển đổi.
Kiểm tra sơ bộ mẫu trước khi xác minh Cline
Cách nhanh nhất để gỡ lỗi một thiết lập API tương thích Cline OpenAI là kiểm tra tuyến đường Flatkey bên ngoài Cline trước. Nếu yêu cầu curl này không thành công, hãy sửa khóa, URL cơ sở hoặc bí danh mô hình trước khi thay đổi cài đặt Cline.
export FLATKEY_API_KEY="fk_replace_me"
export FLATKEY_MODEL="replace-with-your-flatkey-model-alias"
curl https://console.flatkey.ai/v1/chat/completions \
-H "Authorization: Bearer $FLATKEY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "'"$FLATKEY_MODEL"'",
"messages": [
{"role": "user", "content": "Trả về một kiểm tra định tuyến Cline ngắn gọn."}
],
"max_tokens": 32
}'Nếu curl thành công nhưng Cline thất bại, vấn đề có thể là do ánh xạ trường phía Cline, cờ khả năng của mô hình, quyền truy cập mạng từ máy của nhà phát triển hoặc ID mô hình chính xác được lưu trong Cline. Nếu curl thất bại, hãy ghi lại mã trạng thái và nội dung phản hồi trước khi chỉnh sửa Cline.
Các chế độ lỗi cần gỡ lỗi trước tiên
| Triệu chứng | Nguyên nhân có thể | Cách khắc phục |
|---|---|---|
| Khóa API không hợp lệ | Khóa Flatkey đã được sao chép không chính xác, đã hết hạn, thuộc về một môi trường khác, hoặc một khóa nhà cung cấp ngược dòng đã được dán vào thay thế. | Xoay vòng hoặc tạo lại khóa Flatkey, kiểm tra lại bằng curl, sau đó dán vào Cline. |
| Lỗi kết nối | Sai Base URL, thiếu /v1, đường dẫn mạng bị chặn, sự cố proxy, hoặc đường dẫn điểm cuối đầy đủ được dán thay vì URL cơ sở. |
Mở Base URL từ cùng một máy, kiểm tra lại curl, và giữ trường Base URL của Cline là tuyến đường cơ sở của nhà cung cấp. |
| Không tìm thấy mô hình | ID mô hình Cline không khớp với một bí danh Flatkey được bật cho khóa hoặc họ điểm cuối. | Sao chép chính xác bí danh Flatkey từ bảng điều khiển hoặc chế độ xem giá/danh mục, sau đó kiểm tra lại một yêu cầu trò chuyện đơn giản. |
| Kết quả không mong muốn | Sai bí danh mô hình, cờ khả năng không được hỗ trợ, cửa sổ ngữ cảnh không khớp, hoặc một tuyến đường hoạt động khác với hình dạng tương thích OpenAI mong đợi. | Vô hiệu hóa các khả năng tùy chọn, giảm giới hạn token, kiểm tra trò chuyện đơn giản, sau đó bật lại các tùy chọn nâng cao từng cái một. |
| Không thể đối chiếu việc sử dụng | Thiết lập không ghi lại chủ sở hữu khóa, người dùng, bí danh mô hình, môi trường, hoặc không gian làm việc Cline. | Thêm một hàng vào runbook với người dùng hoặc tổ chức Cline, chủ sở hữu khóa Flatkey, bí danh mô hình, họ điểm cuối và khối lượng công việc dự kiến. |
Cấu hình Cline doanh nghiệp với Flatkey
Đối với các nhà phát triển cá nhân, luồng cài đặt VS Code là đủ. Đối với các nhóm được quản lý, tài liệu quản trị của Cline mô tả cấu hình nhà cung cấp từ xa thông qua bảng điều khiển quản trị được lưu trữ. Quản trị viên có thể thêm một điểm cuối tương thích OpenAI làm nhà cung cấp LLM cho toàn tổ chức, chọn OpenAI Compatible, cấu hình một Base URL bắt buộc, thêm các tiêu đề tùy chỉnh tùy chọn và lưu cấu hình cho các thành viên trong tổ chức.
Lộ trình doanh nghiệp đó hữu ích khi tuyến đường API tương thích Cline OpenAI cần nhất quán trong toàn đội. Nó cho phép chủ sở hữu nền tảng tập trung hóa cài đặt nhà cung cấp trong khi vẫn yêu cầu các kiểm tra Flatkey tương tự: URL cơ sở hiện tại, chi tiết xác thực chính xác, bí danh mô hình được phê duyệt và xác minh từ tài khoản thành viên.
| Quyết định của đội | Điểm bắt đầu được đề xuất | Tại sao nó quan trọng |
|---|---|---|
| Cài đặt do nhà phát triển sở hữu | Sử dụng bảng cài đặt tiện ích mở rộng Cline và khóa Flatkey của nhà phát triển hoặc của đội. | Nhanh nhất cho một dự án thí điểm, nhưng mỗi nhà phát triển có thể đi chệch hướng nếu cài đặt không được ghi lại. |
| Cài đặt toàn tổ chức | Sử dụng cấu hình nhà cung cấp từ xa của Cline và đặt OpenAI Compatible làm nhà cung cấp bắt buộc. | Tốt hơn cho các đội cần một tuyến đường Flatkey tiêu chuẩn, quyền truy cập mô hình nhất quán và đánh giá tập trung. |
| Header tùy chỉnh | Để trống trừ khi Flatkey hoặc lớp mạng của bạn yêu cầu rõ ràng. | Các header bổ sung có thể che giấu hành vi định tuyến. Hãy giữ cho cài đặt hoạt động đầu tiên đơn giản. |
Sổ tay vận hành cho Cline và Flatkey
Trước khi có thêm nhiều nhà phát triển sử dụng tuyến đường API tương thích Cline OpenAI, hãy ghi lại các chi tiết sau. Mục tiêu là làm cho việc xử lý lỗi, xem xét chi phí và khôi phục trở nên đơn giản.
| Trường sổ tay vận hành | Ghi lại điều này |
|---|---|
| Phạm vi Cline | Nhà phát triển cá nhân, đội, hoặc cấu hình từ xa toàn tổ chức. |
| Khóa Flatkey | Chủ sở hữu, môi trường, ngày xoay vòng và ai có thể thu hồi nó. |
| URL cơ sở | URL cơ sở chính xác được lưu trong Cline và ngày nó được xác minh. |
| Bí danh mô hình | ID mô hình Cline, bí danh Flatkey, họ điểm cuối và các khả năng dự kiến. |
| Cài đặt khả năng | Cửa sổ ngữ cảnh, số token đầu ra tối đa, hỗ trợ hình ảnh, hành vi sử dụng máy tính/công cụ và bất kỳ trường giá nào được nhập vào Cline. |
| Xem xét sử dụng | Nơi đội kiểm tra khối lượng yêu cầu, chi phí và các thay đổi mô hình không mong muốn sau lời nhắc Cline đầu tiên. |
| Khôi phục | Cấu hình nhà cung cấp trước đó, bí danh mô hình trước đó và ai có thể khôi phục nó. |
Lộ trình di chuyển nội bộ
Nếu đội của bạn đang chuẩn hóa nhiều công cụ tương thích OpenAI trên Flatkey, hãy giữ cho cài đặt Cline nhất quán với phần còn lại của cụm tích hợp. Sử dụng hướng dẫn di chuyển API tương thích OpenAI làm trung tâm di chuyển URL cơ sở chính thức. Đối với một mẫu máy khách để bàn khác, hãy so sánh hướng dẫn cài đặt API Cherry Studio. Đối với định tuyến máy của nhà phát triển với các chuyển đổi mô hình, hãy xem cài đặt cc-switch Claude Code.
Sau khi lời nhắc Cline đầu tiên của bạn hoạt động, hãy xem lại trang giá mô hình Flatkey hiện tại, sau đó Nhận khóa cho bất kỳ người dùng, đội hoặc môi trường bổ sung nào cần một ranh giới thông tin xác thực riêng biệt.
Câu hỏi thường gặp
Tôi nên sử dụng URL cơ sở nào cho nhà cung cấp API tương thích Cline OpenAI?
Bắt đầu với URL cơ sở Flatkey hiện tại được hiển thị cho tài khoản của bạn. Vào ngày 29 tháng 6 năm 2026, trang chủ công khai của Flatkey đã hiển thị https://console.flatkey.ai/v1 trong các ví dụ kiểu OpenAI. Không dán toàn bộ điểm cuối /chat/completions vào trường URL cơ sở của Cline.
ID mô hình Cline có cần khớp chính xác với bí danh mô hình Flatkey không?
Có, hãy sử dụng chính xác bí danh mô hình Flatkey mà khóa của bạn được phép gọi. Tài liệu của Cline nói rằng ID mô hình khác nhau tùy theo nhà cung cấp tương thích OpenAI, vì vậy đừng dựa vào một tên họ chung chung trừ khi Flatkey hiển thị chính xác bí danh đó.
Tôi có thể sử dụng nhà cung cấp OpenAI chính thức trong Cline với Flatkey không?
Sử dụng OpenAI Compatible cho Flatkey. Tài liệu OpenAI Compatible của Cline dành riêng cho các nhà cung cấp khác ngoài API OpenAI chính thức mà có hiển thị một điểm cuối tương thích OpenAI.
Cline có hỗ trợ cấu hình tương thích OpenAI ở cấp độ đội không?
Có. Tài liệu quản trị của Cline mô tả cấu hình nhà cung cấp từ xa, nơi quản trị viên có thể cấu hình một điểm cuối tương thích OpenAI làm nhà cung cấp LLM cho toàn tổ chức, bao gồm URL cơ sở bắt buộc và các header tùy chỉnh tùy chọn.
Tại sao nên kiểm tra bằng curl trước khi xác minh trong Cline?
Một kiểm tra sơ bộ bằng curl giúp tách biệt các vấn đề truyền tải của Flatkey khỏi các vấn đề về trường của Cline. Nếu curl thất bại, hãy sửa khóa, URL cơ sở hoặc bí danh mô hình trước. Nếu curl thành công nhưng Cline thất bại, hãy gỡ lỗi cài đặt Cline, các cờ khả năng, quyền truy cập mạng và ID mô hình đã lưu.
Kết luận
Một cài đặt API tương thích Cline OpenAI đáng tin cậy cần nhiều hơn là chỉ dán một khóa. Xác nhận URL cơ sở của Flatkey, sử dụng bí danh mô hình chính xác, giữ các khả năng của mô hình ở mức thận trọng cho đến khi trò chuyện đơn giản hoạt động, và để lại một sổ tay vận hành kết nối việc sử dụng Cline với việc xem xét thanh toán và định tuyến của Flatkey. Khi bạn đã sẵn sàng để chuẩn hóa tuyến đường, hãy Nhận khóa và kiểm tra lời nhắc Cline nhỏ nhất trước khi chuyển công việc lập trình hàng ngày sang nó.
