Thiết lập Continue.dev OpenAI compatible provider không chỉ là việc chuyển đổi nhà cung cấp mô hình. Đối với một trợ lý lập trình, tuyến này phải chứng minh bốn điều: Continue đang đọc đúng config.yaml được dự định, Flatkey là base URL đứng sau nhà cung cấp OpenAI, alias mô hình đã được bật cho khóa của bạn, và mô hình được chọn có thể hỗ trợ vai trò Continue mà bạn đang gán cho nó.
Hướng dẫn này được viết cho các nhà phát triển, nhóm sản phẩm AI, người xây dựng tự động hóa, kỹ sư nền tảng, nhân sự vận hành tài chính và người xem xét mua sắm muốn có một tuyến tương thích OpenAI duy nhất, có thể kiểm tra được cho Continue và các công cụ AI còn lại của họ. Nội dung bao gồm tài liệu Continue hiện tại, kiểm tra base URL của Flatkey, vai trò mô hình, khả năng dùng công cụ, cơ chế dự phòng endpoint, khả năng hiển thị mức sử dụng và quy trình rollback.
Lưu ý nguồn: nội dung này được kiểm tra vào ngày 29 tháng 6 năm 2026 đối chiếu với trang chủ chính thức Continue, tài liệu nhà cung cấp OpenAI của Continue chính thức, tham chiếu config.yaml của Continue chính thức, hướng dẫn về năng lực mô hình của Continue chính thức, và các trang công khai trực tiếp của Flatkey. Trang chủ của Continue hiện cho biết Continue đã được Cursor mua lại, vì vậy hãy xác minh tiện ích mở rộng Continue, CLI và đường hỗ trợ mà bạn mong muốn trước khi đưa ra quyết định triển khai mới trên toàn đội.
Trả lời nhanh: thiết lập Continue.dev OpenAI compatible provider
Đối với thiết lập Continue.dev OpenAI compatible provider với Flatkey, hãy cấu hình một mô hình trong config.yaml của Continue với provider: openai, đặt apiBase thành base URL nhà cung cấp Flatkey hiện tại của bạn, dùng một khóa API Flatkey, và đặt model thành đúng alias mô hình Flatkey. Sau đó, hãy kiểm tra cùng base URL và alias mô hình đó bên ngoài Continue trước khi dựa vào nó trong một workspace mã nguồn.
| Trường Continue | Giá trị Flatkey | Kiểm tra xác minh |
|---|---|---|
provider |
openai |
Tài liệu provider OpenAI của Continue cho thấy provider này dành cho các endpoint tương thích với OpenAI khi apiBase được ghi đè. |
apiBase |
URL gốc Flatkey hiện tại từ console hoặc tài liệu của bạn, chẳng hạn https://console.flatkey.ai/v1 khi đã được xác minh cho tài khoản của bạn |
Chỉ dùng URL gốc. Không dán toàn bộ endpoint /chat/completions vào apiBase. |
apiKey |
Một khóa Flatkey thuộc sở hữu của đúng người dùng, nhóm hoặc môi trường | Sử dụng luồng secret hoặc biến môi trường được phiên bản Continue của bạn hỗ trợ. Không commit một khóa dạng văn bản thuần. |
model |
Biệt danh model Flatkey chính xác đã được kích hoạt cho khóa | Không dùng tên họ nhà cung cấp trừ khi Flatkey hiển thị đúng biệt danh đó. |
roles và capabilities |
Chỉ gán các vai trò mà model nên phục vụ, và chỉ thêm tool_use sau khi xác nhận hỗ trợ tool/function |
Tài liệu capability của Continue liên kết tool_use với tools và functions, điều này quan trọng cho các luồng công việc Agent. |
Trình tự an toàn là: sao chép URL gốc Flatkey hiện tại, chọn một biệt danh model hiển thị trong tài khoản, kiểm tra endpoint tương thích OpenAI, thêm model vào Continue, chạy một prompt ít rủi ro, và xác minh mức sử dụng trong Flatkey. Phần còn lại của hướng dẫn Continue.dev OpenAI compatible provider này sẽ biến điều đó thành một quy trình có thể lặp lại.
Những gì tài liệu Continue hiện tại xác nhận
Continue hiện tài liệu hóa cấu hình thông qua config.yaml. Hướng dẫn cấu hình của nó cho biết cấu hình cục bộ nằm tại ~/.continue/config.yaml trên macOS/Linux và %USERPROFILE%\.continue\config.yaml trên Windows. Tài liệu cũng cho biết Continue tải lại cấu hình khi tệp được lưu, điều này giúp việc kiểm tra và hoàn nguyên một thay đổi nhỏ ở provider trở nên dễ dàng.
Trang provider OpenAI cho thấy mẫu hình quan trọng đối với Flatkey: một mục model có thể dùng provider: openai, một tên model tương thích OpenAI, một ghi đè apiBase, và một API key. Điều đó khiến đường dẫn Continue.dev OpenAI compatible provider trở thành một tác vụ cấu hình URL gốc và biệt danh model, chứ không phải tác vụ triển khai provider tùy chỉnh.
Tài liệu tham chiếu config.yaml bổ sung các chi tiết vận hành. Các model của Continue có thể chỉ định vai trò như chat, edit, và autocomplete. Continue cũng có thể ghi đè các capability của model, bao gồm tool_use và image_input, khi khả năng tự phát hiện là chưa đủ. Hãy sử dụng các trường này một cách có chủ đích. Một model phù hợp cho autocomplete có thể là lựa chọn sai cho việc sử dụng tool theo kiểu agent.
Thêm một chi tiết về endpoint rất quan trọng: tài liệu nhà cung cấp OpenAI của Continue mô tả các điều khiển endpoint, bao gồm hành vi completions kiểu cũ và việc tắt Responses API khi một route mô hình cần /chat/completions. Trang giá công khai của Flatkey được kiểm tra cho bài viết này liệt kê các họ endpoint bao gồm /v1/chat/completions và /v1/responses, nhưng biệt danh mô hình bạn chọn và quyền tài khoản vẫn cần được xác minh.
Các giá trị của Flatkey cần xác nhận trước khi chỉnh sửa Continue
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ả quyền truy cập mô hình hợp nhất, định tuyến, thanh toán, phân tích sử dụng và các điều khiển vận hành. Ví dụ mã công khai hiện tại của họ sử dụng https://console.flatkey.ai/v1/chat/completions, vì vậy base URL tương ứng cho cấu hình Continue sẽ là https://console.flatkey.ai/v1 khi đó là giá trị được tài khoản của bạn xác nhận.
Trang giá của Flatkey được kiểm tra cùng ngày cho biết hiện tại trang web có 635 mô hình được kích hoạt trên 23 nhà cung cấp. Trang này cũng liệt kê các họ endpoint cho chat completions, responses, messages, images và video. Đây là các факт về danh mục và tuyến công khai, không phải lời hứa rằng mọi khóa đều có thể gọi mọi mô hình. Trước khi lưu một route nhà cung cấp tương thích OpenAI của Continue.dev, hãy xác nhận biệt danh mô hình đó có hiển thị đối với khóa Flatkey mà Continue sẽ sử dụng.
Nếu nhóm của bạn có các tài liệu Flatkey cũ, script hoặc bài đăng blog nhắc đến một base URL khác, đừng sao chép chúng một cách mù quáng. Hãy coi Flatkey Console hoặc tài liệu tài khoản hiện tại là nguồn sự thật, sau đó chạy bước kiểm tra trước triển khai bên dưới từ chính máy sẽ chạy Continue.
Từng bước: cấu hình Continue với Flatkey
- Xác nhận bề mặt Continue. Quyết định xem bạn đang cấu hình tiện ích mở rộng IDE, CLI hay một thiết lập cục bộ hiện có. Vì trang chủ của Continue hiện cho biết họ đã được Cursor mua lại, hãy xác minh đường dẫn hỗ trợ và cài đặt trước khi triển khai mới.
- Mở
config.yamlđang hoạt động. Dùng bộ chọn cấu hình và biểu tượng bánh răng của Continue, hoặc mở~/.continue/config.yamltrên macOS/Linux hay%USERPROFILE%\.continue\config.yamltrên Windows. - Ghi lại mục mô hình trước đó. Lưu provider cũ, model, roles và các cờ endpoint để việc quay lui chỉ là thao tác sao chép-dán.
- Sao chép base URL của Flatkey. Sử dụng base URL của provider, chẳng hạn
https://console.flatkey.ai/v1khi đã được xác minh cho tài khoản của bạn. Không bao gồm/chat/completionstrongapiBase. - Chọn một bí danh model cho mỗi vai trò. Bắt đầu với một model chat/edit và chỉ thêm autocomplete nếu bạn có một model được tinh chỉnh cho vai trò đó.
- Lưu khóa Flatkey một cách an toàn. Dùng mẫu secret, biến môi trường hoặc thông tin xác thực cục bộ được hỗ trợ bởi phiên bản Continue của bạn. Không commit một khóa thô vào cấu hình dùng chung.
- Thêm mục model. Dùng
provider: openai,apiBasecủa Flatkey, bí danh model của Flatkey và giới hạn vai trò. - Chạy kiểm tra preflight bằng curl. Kiểm tra cùng base URL, khóa và model trước khi đánh giá chính Continue.
- Chạy một prompt Continue an toàn. Dùng một nhánh tạm hoặc tác vụ không phá hủy, sau đó kiểm tra mức sử dụng Flatkey về thời điểm, model, token và chi phí.
- Ghi nhận quyền sở hữu. Ghi lại ai sở hữu khóa, ai có thể xoay vòng khóa, bí danh model nào được phê duyệt và khi nào cần xem lại tuyến này.
mẫu config.yaml cho Flatkey
Đây là một mẫu, không phải bản cài đặt dùng chung cho mọi trường hợp. Hãy thay các chỗ giữ chỗ bằng giá trị đã được xác minh trong tài khoản Flatkey của bạn và phiên bản Continue hiện tại của bạn.
name: Flatkey Continue Config
version: 0.0.1
schema: v1
models:
- name: Flatkey chat and edit
provider: openai
model: <flatkey-chat-model-alias>
apiBase: https://console.flatkey.ai/v1
apiKey: <load-from-your-continue-secret-or-env-flow>
roles:
- chat
- edit
- apply
capabilities:
- tool_use
defaultCompletionOptions:
maxTokens: 2000
- name: Flatkey autocomplete
provider: openai
model: <flatkey-autocomplete-model-alias>
apiBase: https://console.flatkey.ai/v1
apiKey: <load-from-your-continue-secret-or-env-flow>
roles:
- autocomplete
autocompleteOptions:
debounceDelay: 350
maxPromptTokens: 1024
Nếu tuyến model bạn chọn gặp trục trặc với /responses, tài liệu provider OpenAI của Continue mô tả tùy chọn useResponsesApi: false. Chỉ dùng tùy chọn này sau khi bạn có bằng chứng rằng model, họ endpoint hoặc tuyến tài khoản cần /chat/completions cho tác vụ đó.
models:
- name: Flatkey chat completions only
provider: openai
model: <flatkey-model-alias>
apiBase: https://console.flatkey.ai/v1
apiKey: <load-from-your-continue-secret-or-env-flow>
useResponsesApi: false
roles:
- chat
- edit
Kiểm tra trước tuyến đường bên ngoài Continue
Một bài kiểm tra curl nhỏ giúp tách riêng các vấn đề định tuyến của Flatkey khỏi các vấn đề cấu hình Continue. Hãy dùng cùng base URL, key và model alias mà bạn định đặt trong config.yaml.
export FLATKEY_API_KEY="fk_replace_me"
export FLATKEY_BASE_URL="https://console.flatkey.ai/v1"
export FLATKEY_CONTINUE_MODEL="replace-with-flatkey-model-alias"
curl "$FLATKEY_BASE_URL/chat/completions" \
-H "Authorization: Bearer $FLATKEY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "'"$FLATKEY_CONTINUE_MODEL"'",
"messages": [
{
"role": "user",
"content": "Return the word ok."
}
],
"max_tokens": 16
}'Đối với tuyến nhà cung cấp tương thích OpenAI của Continue.dev kiểu agent, hãy thêm một bước kiểm tra trước thứ hai với lược đồ công cụ nếu vai trò Continue bạn chọn cần dùng công cụ. Một phản hồi chat thuần túy chứng minh đường truyền, nhưng không chứng minh hành vi function/tool.
curl "$FLATKEY_BASE_URL/chat/completions" \
-H "Authorization: Bearer $FLATKEY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "'"$FLATKEY_CONTINUE_MODEL"'",
"messages": [
{
"role": "user",
"content": "Call route_check with status ok and no prose."
}
],
"tools": [
{
"type": "function",
"function": {
"name": "route_check",
"description": "Return the route status.",
"parameters": {
"type": "object",
"properties": {
"status": { "type": "string" }
},
"required": ["status"]
}
}
}
],
"tool_choice": {
"type": "function",
"function": { "name": "route_check" }
},
"max_tokens": 64
}'Một phản hồi dùng công cụ lành mạnh nên bao gồm cấu trúc tool_calls theo kiểu OpenAI. Nếu yêu cầu này thất bại, hãy sửa key, base URL, model alias, nhóm endpoint hoặc khả năng của model của Flatkey trước khi chỉnh Continue lần nữa.
Danh sách kiểm tra khả năng, vai trò và endpoint
| Quyết định | Cần xác minh gì | Vì sao quan trọng |
|---|---|---|
| Model chat/edit | Model alias có thể trả lời các câu hỏi về code thông qua endpoint Flatkey đã chọn. | Đây là bằng chứng tối thiểu cho các vai trò chat và edit hướng tới nhà phát triển. |
| Dùng công cụ | Model trả về các tool call theo kiểu OpenAI trong một bước kiểm tra trước bằng curl. | Tài liệu về khả năng model của Continue gắn tool_use với tools và functions. |
| Autocomplete | Vai trò riêng, prompt ngắn hơn, độ trễ chấp nhận được từ máy của nhà phát triển. | Autocomplete có kỳ vọng trải nghiệm khác với chat. |
| Responses API | Tuyến model đã chọn hỗ trợ endpoint mà Continue đang gọi. | Một số kết hợp model và gateway cần useResponsesApi: false. |
| Xem lại usage | Flatkey hiển thị request dưới key, thời gian, model và chi phí mong đợi. | Bộ phận tài chính và chủ sở hữu nền tảng cần một nơi để đối soát usage. |
Các chế độ lỗi cần gỡ lỗi trước tiên
Hầu hết các lỗi của nhà cung cấp tương thích OpenAI của Continue.dev xuất phát từ một nhóm nhỏ các điểm không khớp. Hãy kiểm tra những điều này trước khi cho rằng Continue hoặc Flatkey đang gặp sự cố.
| Triệu chứng | Nguyên nhân có khả năng | Cách khắc phục |
|---|---|---|
| Cấu hình không tải | Sai tệp, lỗi thụt lề YAML, hoặc đã chọn một cấu hình cũ trong IDE. | Mở cấu hình thông qua bộ chọn của Continue, xác thực YAML, lưu lại và theo dõi xem có tải lại không. |
| API key không hợp lệ | Key đã được sao chép không đúng, đã bị xoay vòng, bị giới hạn cho môi trường khác, hoặc thuộc về nhà cung cấp thượng nguồn. | Tạo hoặc chọn đúng Flatkey key và kiểm thử lại bằng curl trước khi cập nhật Continue. |
| Lỗi kết nối | apiBase bao gồm toàn bộ đường dẫn endpoint, dùng URL gốc cũ, hoặc máy không thể truy cập tuyến đường đó. |
Chỉ dùng URL gốc của nhà cung cấp hiện tại và kiểm thử từ cùng một máy. |
| Không tìm thấy model | Giá trị model trong Continue không khớp với một bí danh Flatkey được bật cho key. |
Sao chép chính xác bí danh model từ bảng giá Flatkey, danh mục, hoặc danh sách model hiển thị trong tài khoản. |
| Công cụ hoặc chế độ Agent không hoạt động | Model đã chọn không thể tạo ra hành vi công cụ/chức năng mà vai trò mong đợi. | Dùng model có hỗ trợ công cụ và chạy lại bước kiểm tra trước khi gọi công cụ trước khi đặt tool_use. |
| Lỗi theo từng endpoint | Continue đang gọi /responses trong khi tuyến đã chọn nên dùng chat completions, hoặc ngược lại. |
Kiểm tra hỗ trợ endpoint của Flatkey và chỉ dùng các cờ endpoint của Continue khi cần. |
| Không thể đối soát mức sử dụng | Nhóm không ghi lại chủ sở hữu key, bí danh model, nhà phát triển, môi trường, hoặc dấu thời gian. | Thêm một dòng runbook trước khi mở rộng thiết lập cho nhiều nhà phát triển hơn. |
Sổ tay vận hành sản xuất cho Continue cùng Flatkey
Trước khi có thêm nhà phát triển sử dụng tuyến nhà cung cấp tương thích OpenAI của Continue.dev, hãy ghi lại các thông tin vận hành giúp việc hỗ trợ và rà soát chi phí trở nên khả thi.
| Trường runbook | Ghi lại điều này |
|---|---|
| Chủ sở hữu | Nhóm, nhóm nhà phát triển, và người có thể xoay vòng Flatkey key. |
| Bề mặt Continue | Tiện ích mở rộng IDE hoặc CLI, phiên bản nếu có, và vị trí cấu hình. |
| URL gốc Flatkey | URL gốc hiện tại được tài khoản phê duyệt và ngày đã kiểm tra. |
| Bí danh model | Một bí danh cho mỗi vai trò: chat/edit, apply, autocomplete, hoặc luồng tác tử tool-use. |
| Chính sách endpoint | Tuỳ chọn tuyến nên dùng responses, chat completions, hay một phương án dự phòng đã được tài liệu hóa. |
| Rà soát chi phí | Nơi mức sử dụng, số lượng token, trạng thái yêu cầu, và chi phí sẽ được xem xét trong Flatkey. |
| Khôi phục | Mục nhà cung cấp trước đó, bí danh model cũ, và phê duyệt của chủ sở hữu để hoàn nguyên. |
Vị trí của phần này trong một cụm công cụ Flatkey
Nếu nhóm của bạn đã định tuyến các công cụ khác qua Flatkey, hãy giữ cùng mô hình vận hành cho Continue. Hướng dẫn Cherry Studio API setup hữu ích cho các kiểm tra base URL đơn giản của client desktop. Hướng dẫn CC Switch Claude Code Flatkey hữu ích cho kỷ luật định tuyến công cụ dành cho nhà phát triển. Playbook rộng hơn về OpenAI-compatible API migration là nơi để chuẩn hóa các thay đổi base URL, xác minh bí danh mô hình và quy trình rollback.
Giá trị của một bộ định tuyến hợp nhất không chỉ là ít khóa nhà cung cấp hơn. Nó còn là khả năng nhìn thấy công cụ, mô hình, chủ sở hữu khóa và quy trình làm việc nào đã tạo ra mức sử dụng. Đó là lý do một lần di chuyển Continue.dev OpenAI compatible provider nên kết thúc bằng một lượt kiểm tra mức sử dụng trên Flatkey, chứ không chỉ dừng ở một prompt hoạt động được.
Câu hỏi thường gặp
Continue vẫn có hỗ trợ định tuyến tương thích OpenAI không?
Tài liệu nhà cung cấp OpenAI hiện tại của Continue cho thấy một mẫu cấu hình tương thích OpenAI bằng cách dùng provider: openai, model, apiBase và apiKey. Trang chủ của họ cũng nói rằng Continue đã được Cursor mua lại, vì vậy hãy xác minh chính xác extension, CLI và đường dẫn hỗ trợ của bạn trước khi triển khai mới.
Nên dùng base URL Flatkey nào?
Hãy dùng base URL hiện tại của nhà cung cấp từ tài khoản Flatkey của bạn. Trang chủ công khai được kiểm tra cho bài viết này hiển thị https://console.flatkey.ai/v1/chat/completions, ánh xạ thành https://console.flatkey.ai/v1 làm base URL. Tài liệu tài khoản hoặc console của bạn sẽ được ưu tiên nếu khác.
Có nên để một mô hình xử lý mọi vai trò của Continue không?
Không phải lúc nào cũng tự động như vậy. Chat, edit, apply, autocomplete và việc dùng công cụ kiểu agent có thể có nhu cầu khác nhau về độ trễ, ngữ cảnh và khả năng. Hãy bắt đầu với phân công vai trò hẹp nhất và bổ sung thêm vai trò sau khi kiểm thử.
Tôi có cần tool_use không?
Chỉ khi vai trò cần hành vi công cụ/hàm và mô hình được chọn thực sự có thể trả về các tool call kiểu OpenAI. Continue có thể tự phát hiện nhiều khả năng, nhưng tài liệu của họ cho phép ghi đè cho các triển khai tùy chỉnh hoặc các trường hợp tự phát hiện không hoạt động.
Nên xử lý API key như thế nào?
Hãy giữ khóa Flatkey ngoài các tệp trong repository, ảnh chụp màn hình và các bình luận issue được chia sẻ. Dùng mẫu secret cục bộ hoặc biến môi trường được phiên bản Continue của bạn hỗ trợ, rồi ghi lại ai sở hữu khóa và ai có thể xoay vòng khóa đó.
Danh sách kiểm tra cuối cùng
- Đã xác minh bề mặt Continue hiện tại sau thông báo mua lại của Cursor.
- Đã tìm thấy và sao lưu
config.yamlđang hoạt động. - Đã sao chép base URL Flatkey từ nguồn tài khoản hiện tại.
- Đã xác nhận bí danh mô hình cho khóa Flatkey.
- Đã kiểm thử hành vi endpoint chat completions hoặc responses.
- Đã chạy kiểm tra sơ bộ tool-use khi vai trò cần công cụ.
- Đã xem lại mức sử dụng trong Flatkey sau prompt Continue an toàn đầu tiên.
- Đã ghi lại người chịu trách nhiệm rollback và cấu hình trước đó.
Khi những kiểm tra đó hoàn tất, lộ trình nhà cung cấp tương thích OpenAI của Continue.dev sẽ trở thành một tích hợp Flatkey có thể quản lý thay vì thêm một thông tin xác thực của nhà phát triển không được quản lý. Nếu bạn đang chuẩn hóa thêm nhiều công cụ, hãy so sánh các bí danh mô hình và chính sách sử dụng trên bảng giá Flatkey, rồi lấy một khóa cho workspace sẽ sở hữu đợt triển khai đầu tiên.
