OpenCode
Dùng cấu hình OpenCode do API Keys -> Use key tạo hoặc cấu hình OpenAI provider với Base URL /v1. Khởi động OpenCode trong dự án và chỉ chọn mô hình mà Key hiện tại hiển thị; danh sách mô hình cố định của ứng dụng không bảo đảm khả dụng.
Trước khi bắt đầu
Chỉ cài bản hiện tại của ứng dụng từ nhà phát hành chính thức. Trước khi sửa cấu hình cục bộ, tạo một API Key riêng trong bảng điều khiển; không dùng lại Key cá nhân, dùng chung hoặc Key triển khai production.
Windows, macOS và Linux
- Windows: dùng trình cài Windows hiện tại hoặc quy trình PowerShell và đóng mọi tiến trình ứng dụng sau khi đổi tệp cấu hình.
- macOS: dùng ứng dụng đã ký hoặc trình cài terminal chính thức phù hợp CPU; cài đặt trong thư mục home thuộc về người dùng macOS đó.
- Linux / WSL: theo hướng dẫn hiện tại của bản phân phối hoặc CLI chính thức; WSL đọc thư mục home Linux, không phải hồ sơ Windows.
Chọn mô hình
Gọi GET /v1/models bằng Key riêng và chọn một data[].id được trả về. Danh sách theo phạm vi Key là nguồn chính xác; cấu hình cũ, bài viết hoặc bộ chọn ứng dụng không bảo đảm quyền truy cập.
Cấu hình
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"openai": {
"options": {
"baseURL": "https://ai.tavonilo.com/v1",
"apiKey": "sk-your-own-key"
}
}
}
}Xác minh
Kiểm tra Key bằng /v1/models, thực hiện một yêu cầu nhỏ không nhạy cảm và chỉ giữ thời điểm, route, model, trạng thái HTTP và request ID cho hỗ trợ. Timeout không chứng minh tác vụ có tính phí chưa được xử lý, do đó không gửi lại mù quáng yêu cầu dài hoặc yêu cầu ảnh.
Khôi phục an toàn
- 401: thay Key thiếu, đã thu hồi hoặc sai; không dán Key vào yêu cầu hỗ trợ.
- 403: kiểm tra nhóm Key, khả năng thấy model, số dư và quyền route.
- 404: dùng Base URL hiển thị ở đây, không dùng endpoint đầy đủ và không thêm /v1 hai lần.
- 429: đưa công việc vào hàng đợi và tuân theo Retry-After nếu có; không gửi lại batch song song.
- 5xx hoặc timeout: chỉ thử lại có giới hạn khi thao tác an toàn. Giữ thời điểm, route, model, trạng thái HTTP và request ID trong log đã che dữ liệu.
Ranh giới thông tin xác thực
Dùng một Key cho mỗi thiết bị hoặc workload. Không bao giờ gửi API Key, auth.json, prompt riêng tư đầy đủ, mật khẩu, mã xác minh hoặc dữ liệu thanh toán cho hỗ trợ; thu hồi và thay thế Key ngay khi nghi ngờ lộ.