Hướng dẫn tích hợp Kira AI vào OpenCode (Desktop & CLI)

Mở Settings và chọn Custom provider

Trong ứng dụng OpenCode Desktop, bấm vào mục Settings ở thanh menu bên trái, chuyển sang tab Providers, cuộn xuống tìm mục Custom provider và nhấn nút + Connect.

Phóng to

Settings → Providers → Custom provider → Nhấn "+ Connect"

Lấy API key tại Developer Hub của Kira AI

Truy cập vào trang quản trị kiraai.vn/developer/. Tại phần Danh sách API keys, nhấn nút + Tạo khóa mới hoặc sao chép khóa API hiện có (dạng kira_xxxxxxxx...).

Phóng to

Vào kiraai.vn/developer/ → Sao chép API key

Điền thông số Custom Provider trong OpenCode Desktop

Quay lại cửa sổ Custom provider trong OpenCode Desktop và điền các trường dữ liệu sau:

Phóng to

Điền Provider ID, Display name, Base URL và API key

Khai báo danh sách model và lưu cấu hình

Tra cứu mã model tại kiraai.vn/models/. Sau đó tại mục Models trong form, nhấn + Add model để thêm các model bạn muốn sử dụng và nhấn Submit:

Phóng to

Tra cứu model tại kiraai.vn/models (ví dụ: Minimax M3, GLM 5.3, DeepSeek V4)

Thêm các dòng model tương ứng (ví dụ: Model ID minimax-m3-free → Tên hiển thị Minimax M3; Model ID glm-5.3 → Tên hiển thị GLM 5.3):

Phóng to

Thêm model ID và tên hiển thị → Nhấn nút "Submit" để hoàn tất

Chọn model Kira AI và kiểm tra trò chuyện

Mở một phiên làm việc mới (New session). Nhấn vào menu chọn model ở đáy khung nhập tin nhắn, bạn sẽ thấy nhóm Kira AI xuất hiện cùng các model vừa thiết lập. Hãy chọn model mong muốn (ví dụ Minimax M3) và gửi tin nhắn kiểm tra.

Phóng to

Menu model hiển thị nhà cung cấp "Kira AI"

Phóng to

Trò chuyện và nhận câu trả lời thành công từ model Minimax M3 của Kira AI

Mở file cấu hình opencode.jsonc

OpenCode CLI lưu trữ cấu hình toàn cục tại tệp opencode.jsonc (hỗ trợ định dạng JSON có ghi chú). Hãy mở tệp này bằng trình soạn thảo bạn yêu thích:

code ~/.config/opencode/opencode.jsonc
# Hoặc mở trực tiếp trong terminal bằng nano:
nano ~/.config/opencode/opencode.jsonc

Thêm cấu hình Kira AI vào file opencode.jsonc

Thêm khối cấu hình provider của Kira AI vào mục "provider". Bạn sử dụng gói chuẩn @ai-sdk/openai-compatible và khai báo các model mong muốn:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "kira-ai": {
      "name": "Kira AI",
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://kiraai.vn/api/v1",
        "apiKey": "kira_xxxxxxxxxxxxxxxxxxxxxxxx"  ← Thay bằng API key của bạn
      },
      "models": {
        "minimax-m3-free": {
          "name": "Minimax M3"
        },
        "glm-5.3": {
          "name": "GLM 5.3"
        },
        "kira-auto": {
          "name": "Kira Auto"
        },
        "deepseek-v4-flash-0731": {
          "name": "DeepSeek V4 Flash"
        }
      }
    }
  }
}

Khởi động OpenCode CLI trong dự án của bạn

Mở Terminal, di chuyển vào thư mục dự án của bạn và gõ lệnh opencode để bắt đầu:

cd ~/Desktop/vibecode
opencode

Phóng to

Khởi chạy OpenCode CLI từ terminal với lệnh opencode

Trải nghiệm lập trình tốc độ cao cùng Kira AI trên CLI

Trong giao diện TUI của OpenCode, thanh trạng thái đáy sẽ hiển thị rõ ràng: Build · Minimax M3 Kira AI. Khi bạn gửi câu hỏi hay yêu cầu sinh mã, mô hình phản hồi thần tốc (chỉ khoảng 2.5 giây) và hỗ trợ hoàn hảo tiếng Việt.

Phóng to

Giao diện OpenCode CLI hoạt động mượt mà với model Minimax M3 từ Kira AI