Tích hợp Factory Droid CLI

Độ khó ⌨️ Trung cấp　|　Định dạng giao diện Tương thích OpenAI　|　base_url https://byesu.com/v1

Thông tin kết nối

Địa chỉ APIhttps://byesu.com/v1

Khóa APIsk-xxxxxxxxTạo trong bảng điều khiển →

Mô hìnhgpt-5.5

Định dạng API OpenAI tương thích · tên mô hình theo bảng điều khiển

Factory Droid CLI (droid) là một trợ lý lập trình AI chạy trên terminal do Factory AI phát triển, cho phép bạn đọc mã, sửa lỗi, tái cấu trúc và viết tính năng mới ngay trên dòng lệnh. Nó hỗ trợ tùy chỉnh điểm cuối (endpoint) của mô hình, nhờ vậy bạn có thể chuyển backend suy luận sang Byesu API.

Trước khi bắt đầu

Trước tiên hãy vào Bảng điều khiển → Token để tạo một token API (có dạng sk-xxxx), và chọn đúng nhóm cho token — nhóm sẽ quyết định bạn được gọi những mô hình nào và đi theo tuyến nào. Xem chi tiết tại Chọn nhóm.

Bước 1: Cài đặt Droid CLI

Windows

irm https://app.factory.ai/cli/windows | iex

macOS / Linux

curl -fsSL https://app.factory.ai/cli | sh

Sau khi cài đặt xong, hãy làm theo hướng dẫn để cập nhật PATH, và bạn cần đăng nhập một lần bằng tài khoản Factory chính thức miễn phí (chỉ dùng để xác thực phần thân của ứng dụng khách, không ảnh hưởng đến việc mô hình đi qua byesu).

Lưu ý cho Windows

Nếu gặp lỗi về quyền hoặc chính sách thực thi: hãy chạy PowerShell với quyền quản trị viên (administrator), rồi thực thi Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser.

Bước 2: Cấu hình để kết nối byesu

Có hai cách, khuyến nghị dùng script một lần bấm.

Cách một (nhanh nhất): Script một lần bấm

Sau khi chạy, chỉ cần làm theo hướng dẫn để điền base_url và API Key, script sẽ tự động ghi đúng tệp cấu hình:

Windows

iex (irm 'https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/factory-cli-setup.ps1')

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/factory-cli-setup.sh | bash

• base_url điền: https://byesu.com/v1
• API Key điền: token sk-xxxx mà bạn đã tạo trong Bảng điều khiển byesu

Cách hai (thủ công): Chỉnh sửa tệp cấu hình

Chỉnh sửa ~/.factory/config.json (trên Windows là %USERPROFILE%\.factory\config.json), thêm các mục mô hình của byesu vào mảng custom_models:

{
  "custom_models": [
    {
      "model_display_name": "GPT-5.5 [byesu]",
      "model": "gpt-5.5",
      "base_url": "https://byesu.com/v1",
      "api_key": "sk-xxxx",
      "provider": "openai",
      "max_tokens": 128000
    },
    {
      "model_display_name": "Claude Opus 4.8 [byesu]",
      "model": "claude-opus-4-8",
      "base_url": "https://byesu.com/v1",
      "api_key": "sk-xxxx",
      "provider": "openai",
      "max_tokens": 128000
    },
    {
      "model_display_name": "Gemini 3.1 Pro [byesu]",
      "model": "gemini-3.1-pro-high",
      "base_url": "https://byesu.com/v1",
      "api_key": "sk-xxxx",
      "provider": "openai",
      "max_tokens": 128000
    }
  ]
}

Giải thích các trường:

• model: tên mô hình thật trên byesu (ví dụ gpt-5.5, claude-opus-4-8, gemini-3.1-pro-high), nhớ xác nhận nhóm chứa token của bạn có hỗ trợ mô hình đó.
• base_url: cố định là https://byesu.com/v1 (định dạng tương thích OpenAI, có /v1).
• api_key: token sk-xxxx của bạn.
• provider: thống nhất điền openai.
• model_display_name: tên hiển thị trong menu chọn của CLI, bạn có thể tự đặt.

Dùng định dạng gốc của Anthropic

Phần trên dùng điểm cuối tương thích OpenAI (đỡ tốn công nhất). Nếu một mục nào đó muốn đi theo giao thức gốc của Anthropic, hãy đổi provider của mục đó thành anthropic, và đổi base_url thành https://byesu.com (không có /v1). Thông thường cứ giữ openai + https://byesu.com/v1 là được.

Bước 3: Chạy thử để kiểm tra

Khởi động trong thư mục dự án:

cd /path/to/your/project
droid

Sau khi vào giao diện tương tác, dùng /model (hoặc menu chọn mô hình lúc khởi động) để chuyển sang mô hình … [byesu] vừa cấu hình, rồi hỏi vu vơ một câu để nó đọc một tệp hoặc giải thích một đoạn mã. Nếu nó trả lời bình thường, tức là đã kết nối thành công.

Bị kẹt?

• 401 / Unauthorized: api_key điền sai hoặc thiếu tiền tố sk-; hãy xác nhận token chưa bị vô hiệu hóa. Xem chi tiết tại Các lỗi thường gặp #auth.
• Không có kênh khả dụng / no channel: nhóm của token hiện tại không hỗ trợ model mà bạn điền, hãy đổi sang một mô hình khác trong nhóm đó, hoặc Chọn nhóm lại. Xem chi tiết tại Các lỗi thường gặp #no-channel.
• Không đủ hạn mức / 402: số dư tài khoản không đủ, hãy nạp tiền trước. Xem chi tiết tại Các lỗi thường gặp #balance.
• Kết nối thất bại / 404: base_url viết sai — định dạng tương thích OpenAI bắt buộc phải là https://byesu.com/v1 (có /v1).

Xem thêm cách khắc phục tại Các lỗi thường gặp và Chọn nhóm.