Factory Droid

Một mục customModels trong ~/.factory/settings.json — model, baseUrl và provider — đưa Droid tới mọi endpoint hỗ trợ Anthropic Messages hoặc OpenAI Chat Completions.

// ~/.factory/settings.json  (Windows: %USERPROFILE%\.factory\settings.json)
{
  "customModels": [
    {
      "model": "claude-sonnet-5",
      "displayName": "Sonnet 5 [Kunavo]",
      "baseUrl": "https://api.kunavo.com",
      "apiKey": "${KUNAVO_API_KEY}",
      "provider": "anthropic"
    },
    {
      "model": "gpt-5-6-sol",
      "displayName": "GPT-5.6 Sol [Kunavo]",
      "baseUrl": "https://api.kunavo.com/v1",
      "apiKey": "${KUNAVO_API_KEY}",
      "provider": "generic-chat-completion-api"
    }
  ]
}

// Then, in the shell Droid starts from:
//   export KUNAVO_API_KEY=sk-kn-...
// ${VAR_NAME} expansion is a settings.json feature. It does NOT apply to the
// legacy ~/.factory/config.json, which Factory still loads and merges.

Từng bước

1. Tạo khóa tại /app/keys rồi sao chép — khóa chỉ hiển thị một lần. Xuất khóa thành KUNAVO_API_KEY trong shell dùng để khởi chạy Droid, để khóa không bị ghi vào tệp cài đặt.
2. Mở ~/.factory/settings.json (nếu chưa có thì tạo tệp) rồi thêm mảng customModels ở trên. Factory đánh dấu chính xác ba trường là bắt buộc — model, baseUrl và provider — còn displayName là nhãn hiển thị trong bộ chọn.
3. Kiểm tra chính tả của provider. Giá trị phải chính xác là một trong anthropic, openai hoặc generic-chat-completion-api; phần khắc phục sự cố của Factory nêu lỗi chính tả ở đây là nguyên nhân gây ra lỗi "Invalid provider".
4. Chạy /model trong CLI. Các mục của bạn sẽ xuất hiện trong phần Mô hình tùy chỉnh riêng bên dưới các mục của Factory, với nhãn là displayName bạn đã đặt. Factory theo dõi tệp cài đặt, vì vậy chỉ cần lưu là đủ — không cần khởi động lại.
5. Giao cho nó một tác vụ đọc và chỉnh sửa tệp thay vì chỉ chào hỏi. Droid dựa vào việc gọi công cụ trong gần như mọi thao tác, và một lượt trò chuyện thông thường sẽ không kiểm tra được phần đó. Sau đó chạy /cost, nơi Factory báo cáo tỷ lệ cache hit — Kunavo hỗ trợ sẵn các dấu cache_control của Anthropic, còn ghi chú của Factory cho biết trên provider Chat Completions dùng chung, bộ nhớ đệm “tùy thuộc vào provider và không thể đảm bảo”.

Đã kiểm tra đối chiếu với Trang Custom Models (BYOK) của Factory vào 21 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 Factory Droid.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/messages \
  -H "Authorization: Bearer sk-kn-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'

Đặ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.

Những gì mô hình tùy chỉnh trong Droid không thể truy cập

Có ba giới hạn được nêu trong chính các trang của Factory. Mỗi giới hạn ảnh hưởng đến điều bạn nên kỳ vọng ở cấu hình trên, chứ không ảnh hưởng đến việc cấu hình có hoạt động hay không.

• Chỉ dùng được trên các ứng dụng cục bộ. Trang BYOK của Factory nêu rằng mô hình tùy chỉnh khả dụng trong CLI Droid và ứng dụng máy tính, vốn đọc tệp settings.json cục bộ của bạn, và chúng “không xuất hiện trên các nền tảng web hoặc di động được Factory lưu trữ”. Công việc được ủy quyền qua sản phẩm lưu trữ của Factory vẫn tiếp tục dùng suy luận do Factory tính phí, bất kể bạn đã cấu hình khóa nào ở đây.
• Quản trị viên có thể tắt tính năng này. Tài liệu về quyền kiểm soát doanh nghiệp của Factory ghi modelPolicy.allowCustomModels và allowedBaseUrls, lần lượt tắt hoàn toàn BYOK của người dùng hoặc buộc mọi mô hình tùy chỉnh chỉ dùng một máy chủ được phê duyệt. Trên máy được quản lý, hãy kiểm tra điều này trước khi xử lý sự cố tệp.
• Phí gói dịch vụ vẫn được tính. Khóa ở đây được dùng bổ sung chứ không thay thế — Factory tính phí thế nào khi bạn vượt mức BYOK và mức đó là bao nhiêu được đề cập trong hướng dẫn chi phí, không được tính lại trên trang này.

Có một điểm dễ mắc cần biết trước khi sao chép cấu hình từ nơi khác: Factory vẫn tải tệp ~/.factory/config.json cũ với các khóa snake_case custom_models và base_url, rồi gộp tệp đó bên dưới settings.json; tài liệu của Factory nêu rằng phép mở rộng ${VAR_NAME} không áp dụng ở đó. Khóa được ghi dưới dạng giá trị giữ chỗ trong tệp đó sẽ được gửi nguyên văn. Hãy dùng settings.json.