Tích hợp AionUi

Độ khó 🧩 Trung bình　|　Định dạng API 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

AionUi là một ứng dụng máy tính Cowork miễn phí, chạy cục bộ và mã nguồn mở, có giao diện đồ họa và WebUI từ xa, có thể chạy đồng thời nhiều tác nhân AI như Gemini CLI, Claude Code, Codex. Khi cấu hình cho nó các mô hình của Byesu API, bạn có thể dùng các mô hình như gpt-5.5, claude-opus-4-8, gemini-3.1-pro-high để cộng tác làm việc ngay trong một giao diện duy nhất.

Trước khi bắt đầu

Hãy vào Bảng điều khiển → Token để tạo một token API (có dạng sk-xxxx).

Khi tạo, nhất định phải chọn đúng nhóm — nhóm quyết định bạn có thể gọi những mô hình nào và tính phí theo mức giá nào. Không chắc nên chọn nhóm nào? Xem Chọn nhóm.

Bước 1: Tải và cài đặt AionUi

Truy cập trang GitHub Releases và tải gói cài đặt tương ứng với hệ điều hành của bạn:

Địa chỉ tải: https://github.com/iOfficeAI/AionUi/releases
Windows chọn .exe, macOS chọn .dmg, Linux chọn .AppImage.

Sau khi tải xong, nhấp đúp để cài đặt và mở AionUi.

Bước 2: Thêm mô hình Byesu API

AionUi dùng một cấu hình mô hình thống nhất để kết nối với các dịch vụ tương thích OpenAI, và Byesu API thuộc loại này.

Mở AionUi, vào trang Cài đặt (Settings).
Chuyển sang tab Cấu hình mô hình (Model Configuration).
Nhấp Thêm mô hình (Add Model).
Chọn loại nhà cung cấp là NewAPI (hoặc Tương thích OpenAI / Custom).
Điền theo bảng dưới đây:

Trường	Nội dung điền
Địa chỉ API (API Address / base_url)	`https://byesu.com/v1`
Khóa API (API Key)	Token của bạn `sk-xxxx`
Mô hình (Model)	Xem khuyến nghị bên dưới
Giao thức yêu cầu (Request Protocol)	Chọn OpenAI (tương thích); nếu sau khi thêm mô hình claude / gemini mà báo lỗi giao thức hoặc định dạng, hãy chuyển thủ công sang giao thức tương ứng theo từng mô hình

base_url phải kết thúc bằng /v1

Định dạng tương thích OpenAI bắt buộc phải điền https://byesu.com/v1, đừng bỏ sót /v1, cũng đừng thêm dấu gạch chéo thừa hoặc /chat/completions ở cuối.

Sau khi điền khóa xong, chọn mô hình muốn dùng từ danh sách thả xuống; nếu danh sách trống, bạn có thể nhập tên mô hình thủ công. Các mô hình thường dùng:

Mục đích	Tên mô hình
Hội thoại / viết lách thông dụng	`gpt-5.5`
Lập trình / suy luận ngữ cảnh dài	`claude-opus-4-8`
Đa phương thức / ngữ cảnh siêu lớn	`gemini-3.1-pro-high`

Lưu cấu hình.

Bước 3: (Tùy chọn) Cấu hình tác nhân Claude Code

Mỗi tác nhân AI trong AionUi có thể được cấu hình riêng. Trong đó, tác nhân Claude Code đi qua giao diện gốc của Anthropic, base_url khác với định dạng tương thích OpenAI — không có /v1:

Thiết lập tác nhân Claude CodeBiến môi trường tương đương

text

Base URL:  https://byesu.com
API Key:   sk-xxxx
Model:     claude-opus-4-8

bash

ANTHROPIC_BASE_URL=https://byesu.com
ANTHROPIC_AUTH_TOKEN=sk-xxxx
ANTHROPIC_MODEL=claude-opus-4-8

Các tác nhân khác như Gemini CLI, Codex cũng tương tự: trong cấu hình của từng tác nhân, hãy điền base_url tương ứng (định dạng tương thích OpenAI dùng https://byesu.com/v1), khóa và mô hình là được.

Bước 4: Chạy thử để kiểm chứng

Quay lại giao diện trò chuyện, ở phần chọn mô hình trên đầu hãy chọn mô hình bạn vừa cấu hình (ví dụ gpt-5.5), rồi gửi một câu "Xin chào, hãy giới thiệu bản thân trong một câu".

Nếu nhận được phản hồi bình thường, nghĩa là kết nối đã thành công. Nếu dùng tác nhân Claude Code, bạn có thể yêu cầu nó đọc một tệp hoặc thực hiện một tác vụ đơn giản để xác nhận tác nhân hoạt động tốt.

Bị kẹt?

401 / Token không hợp lệ: Kiểm tra xem API Key đã dán đầy đủ chưa, có khoảng trắng thừa không; xác nhận bạn đang dùng sk-xxxx được tạo trong bảng điều khiển Byesu. Xem chi tiết tại Lỗi thường gặp #auth.
Báo không có kênh khả dụng / mô hình không tồn tại: Phần lớn là do token chưa chọn đúng nhóm, hoặc tên mô hình bạn điền không được nhóm hiện tại hỗ trợ. Hãy đổi nhóm khác hoặc đổi tên mô hình, tham khảo Chọn nhóm và Lỗi thường gặp #no-channel.
Không đủ số dư: Khi hạn mức tài khoản cạn kiệt sẽ bị từ chối, hãy nạp tiền trước hoặc đổi nhóm. Xem Lỗi thường gặp #balance.
Không kết nối được / 404: Xác nhận định dạng tương thích OpenAI điền là https://byesu.com/v1, còn tác nhân Claude Code điền là https://byesu.com (không có /v1).

Xem thêm cách khắc phục tại Lỗi thường gặp.

Tích hợp AionUi ​

Bước 1: Tải và cài đặt AionUi ​

Bước 2: Thêm mô hình Byesu API ​

Bước 3: (Tùy chọn) Cấu hình tác nhân Claude Code ​