opencode

Một khối nhà cung cấp trong opencode.json — @ai-sdk/openai-compatible cho chat completions, @ai-sdk/openai khi bạn muốn bề mặt /v1/responses.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "kunavo": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Kunavo",
      "options": {
        "baseURL": "https://api.kunavo.com/v1",
        "apiKey": "{env:KUNAVO_API_KEY}"
      },
      "models": {
        "claude-sonnet-5": {
          "name": "Claude Sonnet 5",
          "limit": { "context": 200000, "output": 64000 }
        },
        "claude-haiku-4-5": { "name": "Claude Haiku 4.5" }
      }
    }
  }
}

Từng bước

1. Tạo khóa tại /app/keys rồi sao chép khóa — khóa chỉ hiển thị một lần.
2. Xuất biến môi trường: export KUNAVO_API_KEY=sk-kn-...
3. Thêm khối nhà cung cấp vào opencode.json — tệp toàn cục tại ~/.config/opencode/opencode.json để áp dụng cho mọi dự án, hoặc tệp trong thư mục gốc của dự án để chỉ áp dụng cho kho lưu trữ này.
4. Khởi chạy opencode rồi chọn model từ danh sách model; nhà cung cấp sẽ xuất hiện dưới tên name mà bạn đã đặt.
5. Để thêm model sau này, thêm khóa khác bên dưới models — mã là giá trị được gửi qua giao thức, còn name chỉ là nhãn.

Đã kiểm tra đối chiếu với tài liệu về nhà cung cấp của opencode vào 6 tháng 9, 2026. Cài đặt của bên thứ ba có thể thay đổi; nếu tên trường ở đây không còn khớp với những gì bạn thấy, trang đó là nguồn có thẩm quyền, không phải trang này.

Xác minh trước khi gỡ lỗi ứng dụng khách

Một yêu cầu sẽ xác định liệu lỗi nằm ở endpoint, khóa hay tệp cấu hình. Nếu lệnh này trả về JSON, cùng base URL và khóa sẽ hoạt động trong opencode.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Đặt model id nào vào trường

Mọi mô hình văn bản đều có thể truy cập bằng model id — danh sách đang hoạt động là GET /v1/models, còn danh mục kèm giá nằm trên trang mô hình. Mức giá tính bằng USD trên mỗi 1M token, đầu vào / đầu ra.