OpenCode với Muapi

Thêm Muapi làm nhà cung cấp tùy chỉnh tương thích OpenAI trong OpenCode để dùng các mô hình văn bản Muapi.

1. Tạo khóa và chọn mô hình

Tạo khóa API trong bảng điều khiển Muapi, sau đó liệt kê mô hình văn bản:

curl -s "https://api.muapi.ai/v1/models?type=text" \
  -H "Authorization: Bearer $MUAPI_API_KEY"

Chọn mô hình có capabilities.tools: true. OpenCode cần hỗ trợ công cụ để chỉnh sửa tệp và thao tác terminal.

2. Thêm Muapi làm nhà cung cấp

Đặt biến môi trường MUAPI_API_KEY trong shell chạy OpenCode (macOS/Linux):

export MUAPI_API_KEY="your-muapi-api-key"

Thêm nhà cung cấp sau vào opencode.json cấp dự án hoặc toàn cục:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "muapi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Muapi",
      "options": {
        "baseURL": "https://api.muapi.ai/v1",
        "apiKey": "{env:MUAPI_API_KEY}"
      },
      "models": {
        "YOUR_MODEL_ID": { "name": "Muapi text model" }
      }
    }
  }
}

Thay YOUR_MODEL_ID bằng ID chính xác trong danh sách Muapi. Giữ khóa trong biến môi trường, không đặt trong cấu hình dùng chung hoặc được commit.

3. Chọn mô hình

Khởi chạy OpenCode, chạy /models và chọn mô hình thuộc nhà cung cấp Muapi. Thử một tác vụ lập trình nhỏ để xác nhận có thể đọc và sửa tệp.

Khắc phục sự cố

• Nếu Muapi không xuất hiện trong /models, kiểm tra cú pháp, ID mô hình và quyền đọc tệp cấu hình.
• Nếu lỗi xác thực, kiểm tra MUAPI_API_KEY trong môi trường khởi chạy OpenCode.
• Nếu mô hình không dùng công cụ, chọn mô hình có capabilities.tools: true.
• Prompt dự án lớn có thể nhanh chóng tiêu tốn credit. Bắt đầu bằng tác vụ nhỏ và kiểm tra bảng điều khiển.

Xem tài liệu nhà cung cấp OpenCode để biết tùy chọn hiện tại.