# Lưu trữ hình ảnh

> Vì sao cần tải ảnh tham chiếu lên mạng, thứ tự máy chủ tải ảnh và cách cấu hình adayroi Drive, tmpfiles.org, BytePlus TOS, PiXhost, máy chủ riêng.
Nguồn: https://studio.adayroi.online/docs/cai-dat-luu-tru-hinh-anh

Nhiều model AI chỉ nhận ảnh tham chiếu dưới dạng **đường link công khai** (`https://…`) chứ không nhận file trên máy. **Lưu trữ hình ảnh** tự tải ảnh tham chiếu lên một máy chủ và đưa link cho model.

![Cài đặt → Lưu trữ hình ảnh](https://studio.adayroi.online/media/public/docs/guide/cai-dat-image-hosting.webp)

## Bật lưu trữ

Tick **Bật lưu trữ hình ảnh**. Khi tắt, cấu hình vẫn được giữ nhưng app không tải ảnh lên — model nào bắt buộc link sẽ báo *"cần bật image host"*.

## Thứ tự máy chủ tải ảnh

Danh sách máy chủ được thử **từ trên xuống**:

1. Máy chủ đầu tiên **đang tick** và **đã cấu hình đủ** được dùng.
2. Nếu tải lỗi, app tự chuyển sang máy chủ kế tiếp.
3. Máy chủ chưa cấu hình đủ bị bỏ qua.

Tick để bật/tắt từng máy chủ, dùng ▲ ▼ để đổi thứ tự, **Đặt lại** để về mặc định. Ảnh đã là link `https://` thì không tải lại.

| Máy chủ | Đặc điểm |
| --- | --- |
| **adayroi** | Máy chủ của ứng dụng (Adayroi Drive). |
| **tmpfiles.org** | Miễn phí, không cần đăng ký, file tự xoá sau thời gian lưu. Hợp làm phương án dự phòng. |
| **BytePlus TOS** | Kho lưu trữ kiểu S3 của BytePlus, cần key riêng. |
| **PiXhost** | Dịch vụ ảnh miễn phí. |
| **Máy chủ riêng** | Máy chủ ảnh của bạn (đăng nhập bằng email/mật khẩu để lấy token). |

![Cấu hình từng máy chủ](https://studio.adayroi.online/media/public/docs/guide/cai-dat-image-hosting-2.webp)

## Cấu hình từng máy chủ

### Adayroi Drive

App dùng **API token** để xin URL tải lên rồi đẩy file thẳng lên kho S3 của Adayroi Drive.

- **Địa chỉ API** (mặc định `https://drive.adayroi.online/api/v1`), **API Token** (lấy từ tài khoản Adayroi).
- **Loại upload** (mặc định `bedrive`), **Backend ID** — chỉ đổi khi được Adayroi cung cấp.
- **Thông tin S3**: Endpoint, Vùng (Region), Bucket, Access Key ID, Secret Access Key.

### BytePlus TOS

- **Access Key ID / Secret Access Key** — tạo ở *BytePlus Console → IAM → Access Key Management*.
- **Region**, **Bucket**, **Endpoint** dạng `tos-<region>.bytepluses.com` (**không** có `https://`), lấy ở *TOS → Bucket → Overview*.

### tmpfiles.org

Không cần key. Tối đa **100 MB** mỗi file. **Thời gian lưu file** từ 60 đến 172 800 giây (tối đa 48 giờ, mặc định 1 giờ) — đủ lâu để model đọc ảnh xong.

![tmpfiles.org và PiXhost](https://studio.adayroi.online/media/public/docs/guide/cai-dat-image-hosting-3.webp)

### PiXhost

- **URL cơ sở API / tên miền** — đổi khi PiXhost đổi tên miền.
- **Loại nội dung**: An toàn cho gia đình / Người lớn; **Kích thước thumbnail tối đa**.

### Máy chủ hình ảnh riêng

Điền **URL cơ sở API**, **Email tài khoản**, **Mật khẩu**, **ID chiến lược tải lên** (để trống = mặc định). Khi bấm **Lưu**, app gọi `/tokens` để lấy **Token** mới; đổi email/mật khẩu thì lần lưu sau tự làm mới token.

![Máy chủ riêng](https://studio.adayroi.online/media/public/docs/guide/cai-dat-image-hosting-4.webp)

> [!WARNING]
> Key, mật khẩu và token chỉ lưu trên máy bạn. Không chia sẻ **Secret Access Key** cho ai, và nhớ rằng ảnh đã tải lên máy chủ công khai có thể bị người có link xem được.