# Windsurf

Nguồn: https://docs.aicentos.com/vi/clients/windsurf

Language: vi

> Nhập endpoint và API Key của aicentos trong Windsurf nếu bản của bạn hỗ trợ Base URL tùy chỉnh

Tài liệu này hướng dẫn cách dùng cấu hình OpenAI tương thích tùy chỉnh trong Windsurf để kết nối dịch vụ hiện tại. Khả năng BYOK và cấu hình mô hình tùy chỉnh của các phiên bản Windsurf không hoàn toàn giống nhau, nên ở đây phân biệt hai tình huống để nói.

## Trước tiên xác nhận phiên bản của bạn có hỗ trợ Base URL tùy chỉnh không

Trong phần mô hình, gói đăng ký hoặc cài đặt AI của Windsurf, tìm các mục nhập tương tự sau:

* `Models`
* `BYOK`
* `OpenAI`
* `Custom`
* `Base URL`

Nếu bạn chỉ có thể điền API Key chính thức, mà không có Base URL nào có thể sửa, thì phiên bản này thường chỉ đi được chế độ BYOK mà chính thức hỗ trợ, không thể đổi thẳng sang gateway hiện tại.

## Điền thông tin kết nối tùy chỉnh

Nếu phiên bản của bạn cung cấp cấu hình OpenAI tương thích tùy chỉnh, thì điền:

* Base URL: `https://aicentos.com/v1`
* API Key: Key của bạn dạng `codex_...` hoặc `sk-...`
* Model ID: lấy kết quả trả về của `GET /v1/models` làm chuẩn; nếu chỉ muốn thử kết nối trước, có thể thử `gpt-6-astra`

## Kiểm tra

Sau khi lưu cài đặt, tạo một hội thoại Cascade mới hoặc tác vụ code, xác nhận có thể trả về kết quả bình thường.

## Lưu ý

* Base URL nên điền `https://aicentos.com/v1`
* Đừng viết thành đường dẫn đầy đủ `/v1/chat/completions` hay `/v1/responses`
* Nếu phiên bản hiện tại chỉ mở BYOK chính thức, không có Base URL tùy chỉnh, thì không thể kết nối thẳng gateway này
* Trang giải thích mô hình chính thức của Windsurf: `https://docs.windsurf.com/windsurf/models`