OpenCode

Cấu hình API bên thứ ba OpenCode trên Fast-Token

OpenCode là trợ lý lập trình AI mã nguồn mở, hỗ trợ tích hợp API tùy biến cao. Khi cấu hình API bên thứ ba, bạn có thể tự do chọn các mô hình hiệu năng cao hơn hoặc chi phí tốt hơn (như DeepSeek, SiliconFlow, v.v.).

Bước 1: Chuẩn bị thông tin API cốt lõi

Trước khi cấu hình, hãy chuẩn bị:

1. API Key: khóa ủy quyền của bạn. Nền tảng Fast-Token
2. Base URL: địa chỉ endpoint (ví dụ https://fast-token.com/v1).
3. Model ID: tên mô hình cụ thể (ví dụ deepseek-ai/DeepSeek-V3).

Bước 2: Mở màn hình cấu hình

1. Khởi chạy OpenCode.
2. Nhấp biểu tượng bánh răng cài đặt ở góc dưới bên trái -> Settings.
3. Trong ô tìm kiếm, nhập OpenCode hoặc AI Provider.
4. Tìm hộp chọn Provider và đặt thành OpenAI Compatible (hoặc Custom).

Bước 3: Điền tham số

1. Đặt Base URL

Tìm mục OpenAI Compatible: Base URL và nhập địa chỉ proxy bên thứ ba.

Lưu ý: địa chỉ phải kết thúc bằng /v1, không bao gồm /chat/completions.

2. Gắn API Key

Tìm mục OpenAI Compatible: API Key và dán khóa của bạn.

3. Định nghĩa danh sách mô hình

Tìm mục Custom Models hoặc Model Map:

• Nhấp Add Item.
• Nhập tên hiển thị trên giao diện (ví dụ DeepSeek).
• Nhập ID mô hình thực tế từ nhà cung cấp API (ví dụ deepseek-chat).

Bước 4: Bật và kiểm tra

1. Mở cửa sổ Chat của OpenCode (thường là biểu tượng robot trên thanh bên).
2. Trong bộ chuyển mô hình ở dưới cùng, chọn Custom Model vừa thêm.
3. Gửi một lệnh để kiểm tra kết nối (ví dụ: viết quicksort).

Nâng cao: biến môi trường (dành cho nhà phát triển)

Nếu bạn quen quản lý qua terminal hoặc môi trường hệ thống, OpenCode cũng đọc file .env hoặc biến môi trường hệ thống. Bạn có thể đặt:

• OPENAI_API_BASE: URL bên thứ ba
• OPENAI_API_KEY: khóa của bạn

Xử lý sự cố

Thông báo lỗi	Nguyên nhân có thể	Cách khắc phục
Model Not Found	ID mô hình không khớp	Kiểm tra danh sách mô hình trên bảng điều khiển nhà cung cấp, đảm bảo ID khớp hoàn toàn.
Invalid API Key	Khóa hết hạn hoặc sao chép sai	Tạo lại khóa và đảm bảo không có ký tự xuống dòng thừa.
Network Error	Vấn đề chứng chỉ hoặc proxy	Nếu dùng relay trong nước, kiểm tra có cần bật/tắt proxy mạng cụ thể hay không.
Stream Mode Error	API không hỗ trợ streaming	Thử tắt Enable Streaming trong cài đặt (hầu hết API hiện đại đều hỗ trợ).

Gợi ý: OpenCode tương thích tốt với mô hình mã nguồn mở. Nếu bạn chạy LM Studio hoặc LocalAI cục bộ, chỉ Base URL tới http://localhost:xxxx/v1 để có trợ lý code hoàn toàn ngoại tuyến.