Cấu hình OpenCode dùng TaiKhoanGiaRe làm provider tuỳ chỉnh

Hướng dẫn thêm TaiKhoanGiaRe làm provider tuỳ chỉnh trong OpenCode: lấy API key, cấu hình config.json, chọn model id và mẹo tiết kiệm chi phí.

OpenCode là một agent lập trình chạy trong terminal, hoạt động tương tự Claude Code hay Codex CLI nhưng cho phép bạn gắn bất kỳ model nào thông qua provider tuỳ chỉnh. Vì TaiKhoanGiaRe cung cấp endpoint tương thích OpenAI, bạn có thể trỏ OpenCode vào đó và dùng Claude, GPT, DeepSeek hay các model khác mà không cần tài khoản riêng của từng hãng. Bài này đi theo đúng hướng dẫn OpenCode trong /integrations.html?app=opencode, chỉ dùng những bước thực tế.

Vì sao gắn OpenCode với TaiKhoanGiaRe

Thay vì phải mua riêng key của Anthropic, OpenAI, DeepSeek... bạn chỉ cần một API key duy nhất từ TaiKhoanGiaRe, nạp credit theo gói, rồi chọn model id tương ứng trong OpenCode. Giá được tính theo token thực tế dùng, không có phí thuê bao, và job lỗi được hoàn credit.

Bước 1: Lấy API key

Đăng nhập vào /dashboard.html, mở tab API keys. Mỗi tài khoản chỉ có đúng một secret key, được tạo tự động khi đăng ký. Bạn chỉ cần bấm Show để xem, hoặc Rotate nếu muốn tạo key mới (lưu ý Rotate sẽ vô hiệu hoá key cũ ngay lập tức, nên nhớ cập nhật lại ở mọi nơi đang dùng key đó).

Lưu key này lại, ví dụ export ra biến môi trường trong shell:

export TKGR_API_KEY="sk-xxxxxxxxxxxxxxxx"

Bước 2: Cấu hình provider trong OpenCode

OpenCode đọc cấu hình provider từ file config (thường là opencode.json ở thư mục project hoặc ~/.config/opencode/config.json). Vì TaiKhoanGiaRe tương thích OpenAI SDK với base URL https://taikhoangiare.vn/v1, bạn khai báo một provider dạng OpenAI-compatible rồi liệt kê các model id muốn dùng:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "taikhoangiare": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "TaiKhoanGiaRe",
      "options": {
        "baseURL": "https://taikhoangiare.vn/v1",
        "apiKey": "{env:TKGR_API_KEY}"
      },
      "models": {
        "claude-sonnet-5": {},
        "gpt-5.5": {},
        "deepseek-v4-flash": {}
      }
    }
  }
}

Lưu file, mở lại terminal (hoặc khởi động lại OpenCode) để nó nạp provider mới. Vì OpenCode dùng chuẩn OpenAI-compatible, auth được gửi qua header Authorization: Bearer giống như khi gọi trực tiếp /v1/chat/completions hoặc /v1/responses trên TaiKhoanGiaRe.

Nếu muốn dùng endpoint kiểu Anthropic

Nếu công cụ hoặc fork OpenCode bạn dùng hỗ trợ provider kiểu Anthropic, base URL tương ứng là https://taikhoangiare.vn (không có /v1), auth qua header x-api-key. Phần lớn trường hợp với OpenCode, dùng nhánh OpenAI-compatible ở trên là đơn giản và ổn định hơn.

Bước 3: Chọn model id và kiểm tra

Trong OpenCode, chạy lệnh chọn model (ví dụ /models trong phiên chat) để chọn provider taikhoangiare và model id vừa khai báo. Danh sách model id đầy đủ cùng giá bạn có thể tra ở /models.html, các id phổ biến gồm claude-sonnet-5, claude-opus-5-5, gpt-5.5, deepseek-v4-flash, cùng nhiều lựa chọn khác như grok-4.6, kimi-k3.

Thử một yêu cầu đơn giản để xác nhận kết nối hoạt động, ví dụ nhờ agent đọc một file nhỏ trong project và tóm tắt. Nếu nhận được phản hồi bình thường, provider đã cấu hình đúng.

Mẹo chọn model theo chi phí

Vì OpenCode có thể gọi model liên tục trong một phiên làm việc (đọc file, chạy agent nhiều lượt), chi phí sẽ phụ thuộc nhiều vào model bạn chọn. Prompt caching đã được bật sẵn trên TaiKhoanGiaRe, phần context lặp lại giữa các lượt gọi được tính theo giá cache read thấp hơn giá input thường.

Bảng dưới so sánh chi phí ước tính cho một lượt agent điển hình (100.000 token đọc cache, 5.000 token input mới, 1.000 token output), tính theo giá trên TaiKhoanGiaRe:

Với công việc đơn giản như đọc code, viết commit message hay refactor nhỏ, deepseek-v4-flash hoặc gpt-5.5 thường đủ dùng và rẻ hơn đáng kể. Để các task cần suy luận sâu hơn (thiết kế kiến trúc, review logic phức tạp) cho claude-sonnet-5 hoặc claude-opus-5-5 sẽ hợp lý hơn. Bạn có thể khai báo nhiều model trong cùng một provider như ví dụ config ở trên và chuyển đổi tuỳ task bằng lệnh chọn model của OpenCode.

Nếu muốn tìm hiểu thêm các kỹ thuật giảm chi phí token khi gọi API LLM, có thể xem bài Tối ưu chi phí token khi gọi API LLM.

Nạp credit và theo dõi chi tiêu

TaiKhoanGiaRe hoạt động theo mô hình prepaid credit, 1 credit = 55,8đ, không có thuê bao định kỳ. Bạn nạp tiền bằng chuyển khoản VietQR qua PayOS ở tab Billing trong dashboard. Các gói hiện có:

Xem chi tiết các gói ở /pricing.html. Sau khi dùng OpenCode một thời gian, bạn có thể vào tab Usage trong dashboard để xem chi tiêu theo ngày, 7 ngày, 30 ngày và theo từng sản phẩm, giúp biết model nào đang tốn nhiều credit nhất để điều chỉnh.

Một vài lưu ý khi dùng chung với OpenCode

• Nếu một request bị lỗi phía server, credit tương ứng sẽ được hoàn lại, không mất tiền cho job thất bại.
• Khi Rotate key, nhớ cập nhật lại biến môi trường TKGR_API_KEY trong shell và restart OpenCode, vì key cũ sẽ ngừng hoạt động ngay.
• Nếu cần test nhanh key hoạt động trước khi gắn vào OpenCode, có thể gọi thử bằng cURL theo hướng dẫn chung ở /integrations.html.
• Có vấn đề phát sinh khi cấu hình, có thể liên hệ hỗ trợ qua Telegram @taikhoangiare hoặc email support@taikhoangiare.vn.

Tổng kết

Gắn OpenCode với TaiKhoanGiaRe chỉ cần ba bước: lấy API key từ dashboard, khai báo provider OpenAI-compatible trong config.json với base URL https://taikhoangiare.vn/v1, và chọn model id phù hợp cho từng task. Nhờ prompt caching và nhiều lựa chọn model với mức giá khác nhau, bạn có thể dùng model rẻ cho việc lặt vặt và chuyển sang model mạnh hơn khi cần, tất cả quản lý qua một tài khoản credit duy nhất.

Câu hỏi thường gặp

OpenCode có cần tài khoản riêng của Anthropic hay OpenAI không?

Không, chỉ cần API key từ TaiKhoanGiaRe và base URL tương thích OpenAI https://taikhoangiare.vn/v1 là đủ để OpenCode gọi được các model.

Một tài khoản TaiKhoanGiaRe có nhiều API key để tách riêng cho OpenCode không?

Không, mỗi tài khoản chỉ có đúng một secret key, bạn dùng chung key đó cho mọi công cụ, chỉ Rotate khi cần thay key mới.

Dùng model nào trong OpenCode để tiết kiệm chi phí nhất?

Theo bảng chi phí tính trên giá TaiKhoanGiaRe, deepseek-v4-flash và gpt-5.5 có chi phí mỗi lượt thấp hơn nhiều so với các model Claude, phù hợp cho task đơn giản.

Nếu một lượt gọi model qua OpenCode bị lỗi thì có mất credit không?

Không, các job lỗi được hoàn credit theo chính sách của TaiKhoanGiaRe.

← Về trang Blog