Hướng dẫn kết nối trung chuyển cho Windsurf: Cấu hình endpoint tùy chỉnh cho tác nhân Cascade

1. Windsurf là gì

Windsurf là một IDE ưu tiên AI, tích hợp sẵn tác nhân thông minh Cascade và hỗ trợ thêm các điểm cuối (endpoint) mô hình tùy chỉnh. Bằng cách trỏ tới cổng kết nối (gateway) của trang web này, bạn có thể sử dụng một khóa API duy nhất để gọi các mô hình Claude / GPT / Gemini.

2. Chuẩn bị

1. Đăng nhập vào bảng điều khiển API của Jizhi, tạo API Key dạng sk-xxxxxx (chỉ hiển thị một lần, vui lòng lưu lại).
2. Xác nhận slug của mô hình bạn muốn sử dụng (ví dụ: claude-sonnet-5, gpt-5.4, gemini-3.7-flash).
3. Xác nhận địa chỉ cổng kết nối: https://www.relay-api.com.

3. Cấu hình trong Windsurf

Mở Settings → Models / API Providers → Add Provider, chọn loại nhà cung cấp rồi điền thông tin sau:

Base URL : https://www.relay-api.com        # Claude / Anthropic
API Key  : sk-khóa_của_bạn
Model    : claude-sonnet-5
(Đối với mô hình GPT, thay đổi Base URL thành https://www.relay-api.com/v1)
(Đối với mô hình Gemini, thay đổi Base URL thành https://www.relay-api.com/v1beta)

Sau khi lưu, hãy chọn mô hình đó trong Cascade và nhấn Ctrl+L (macOS Cmd+L) để bắt đầu cuộc trò chuyện.

4. Đối chiếu địa chỉ giao diện (API)

Nhóm mô hình	Cổng vào (Base URL)	Giao thức
Claude / Anthropic	https://www.relay-api.com	Anthropic Messages
GPT / OpenAI	https://www.relay-api.com/v1	OpenAI Chat Completions
Gemini	https://www.relay-api.com/v1beta	Google generateContent

Sử dụng cổng vào từ bảng trên làm Base URL.

5. Xử lý sự cố thường gặp

Hiện tượng	Xử lý
401 / 403	Khóa không hợp lệ, chưa được kích hoạt hoặc không đủ số dư; kiểm tra lại sk- và nạp tiền.
404 / Mô hình không khả dụng	Tên mô hình không khớp với slug của nền tảng, hoặc mô hình chưa được bật; kiểm tra lại ID mô hình.

Khuyến nghị bảo mật: Không đẩy (push) khóa API lên các kho lưu trữ công khai (public repo); nên tạo các Key riêng biệt cho từng mục đích sử dụng để thuận tiện cho việc thống kê và quản lý hạn mức.