OpenCode

Hướng dẫn cài đặt OpenCode

Thêm UnoRouter làm nhà cung cấp tùy chỉnh trong OpenCode và chọn mô hình bất kỳ làm tác nhân đang dùng.

Tổng quan

OpenCode đọc nhà cung cấp từ một tệp cấu hình JSON. Thêm UnoRouter với bộ chuyển đổi tương thích OpenAI để dùng mọi mô hình UnoRouter.

Cấu hình nhanh

Dán những giá trị này vào ứng dụng khách. Khóa của bạn tự điền khi đã đăng nhập.

text

URL cơ sở: https://api.unorouter.com/v1
Khoá API: YOUR_API_KEY

Đăng nhập để tự động điền API key

Tương thích

Chat CompletionsTruyền phátGọi công cụ

Thiết lập từng bước

1
Mở tệp cấu hình OpenCode
Mở tệp cấu hình OpenCode bằng trình soạn thảo văn bản. Tạo tệp nếu nó chưa tồn tại.
powershell
$f = "$env:USERPROFILE\.config\opencode\opencode.json" md -Force (Split-Path $f) | Out-Null; New-Item $f -ea 0 | Out-Null; Invoke-Item $f
Đăng nhập để tự động điền API key

Thay thế nội dung tệp

Thêm khối nhà cung cấp UnoRouter vào cấu hình của bạn. Hợp nhất nó vào tệp hiện có và giữ lại các khối mcp hoặc agent bạn đang dùng.

json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "unorouter-live": {
      "name": "UnoRouter",
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "apiKey": "YOUR_API_KEY",
        "baseURL": "https://api.unorouter.com/v1"
      },
      "models": {
        "ling-3.1-flash:free": {},
        "agnes-3.0-flash:free": {},
        "minicpm5-2b:free": {},
        "k2-horizon:free": {},
        "qwen3.8-flash-next:free": {}
      }
    }
  }
}

Đăng nhập để tự động điền API key

3
Kiểm tra mô hình đã nạp
Lưu tệp rồi chạy opencode models trong terminal. Mọi id bạn đã liệt kê đều phải xuất hiện, kèm tiền tố là khóa nhà cung cấp của bạn.
bash
opencode models
Đăng nhập để tự động điền API key
4
Chọn một mô hình
Mở bộ chọn mô hình và chuyển sang mô hình mới của bạn. Bộ chuyển đổi lo phần luồng và gọi công cụ.

Mô hình đề xuất

Các mô hình miễn phí hoạt động ở đây. Dán bất kỳ model id nào vào ứng dụng khách.

ling-3.1-flash:freeagnes-3.0-flash:freeminicpm5-2b:freek2-horizon:freeqwen3.8-flash-next:free

Lưu ý

OpenCode không có cơ chế tự phát hiện mô hình cho các nhà cung cấp tương thích OpenAI. Mọi mô hình bạn muốn dùng đều phải được liệt kê trong khối "models" với id chính xác.
Đừng đặt khóa nhà cung cấp chỉ là "unorouter". Id đó đã có trong sổ đăng ký models.dev, nên OpenCode sẽ dùng danh sách của họ thay vì của bạn và thiếu các mô hình mới. Hậu tố "-live" ở trên giúp tránh xung đột.
Dùng đúng id mô hình trong danh mục UnoRouter. Bỏ tiền tố nhà cung cấp do sao chép thêm vào, và giữ hậu tố :free ở những id có nó.
Khóa nhà cung cấp tùy chỉnh mà không có khối "models" sẽ nạp không mô hình nào, nên nhà cung cấp biến mất hoàn toàn khỏi bộ chọn.

Tạo API Key Mô hình