---
title: "Lệnh pixgamma (CLI)"
url: https://phatdev.net/docs/pixgamma/cli
lang: vi
updated: 2026-10-22
alternate:
  en: https://phatdev.net/en/docs/pixgamma/cli
markdown: https://phatdev.net/docs/pixgamma/cli.md
---

# Lệnh pixgamma (CLI)

Thuộc bộ tài liệu: [PixGamma](https://phatdev.net/docs/pixgamma.md)

> Xử lý hàng loạt, toàn bộ cờ, báo cáo JSON và các lệnh khác.

Lệnh `pixgamma` dùng chung engine với app, hợp để xử lý hàng loạt hoặc gọi từ script. Cài bằng **Cài lệnh pixgamma (CLI).command** trong DMG.

<div style="margin:1.6em 0"><figure style="margin:0"><a href="https://phatdev.net/uploads/p/pixgamma/cli-dev-vi-light-3840.webp" target="_blank" rel="noopener" class="pd-th-light" style="display:block;border:0" aria-label="Cho lập trình viên: lệnh pixgamma xử lý hàng loạt, báo cáo JSON, API cục bộ (4K)"><img src="https://phatdev.net/uploads/p/pixgamma/cli-dev-vi-light-1920.webp" srcset="/uploads/p/pixgamma/cli-dev-vi-light-960.webp 960w, /uploads/p/pixgamma/cli-dev-vi-light-1920.webp 1920w, /uploads/p/pixgamma/cli-dev-vi-light-3840.webp 3840w" sizes="(max-width: 900px) 100vw, 760px" width="3840" height="2160" alt="Cho lập trình viên: lệnh pixgamma xử lý hàng loạt, báo cáo JSON, API cục bộ" loading="lazy" decoding="async" style="width:100%;height:auto;display:block;border:1px solid var(--line);border-radius:12px"></a><a href="https://phatdev.net/uploads/p/pixgamma/cli-dev-vi-dark-3840.webp" target="_blank" rel="noopener" class="pd-th-dark" style="display:block;border:0" aria-label="Cho lập trình viên: lệnh pixgamma xử lý hàng loạt, báo cáo JSON, API cục bộ (4K)"><img src="https://phatdev.net/uploads/p/pixgamma/cli-dev-vi-dark-1920.webp" srcset="/uploads/p/pixgamma/cli-dev-vi-dark-960.webp 960w, /uploads/p/pixgamma/cli-dev-vi-dark-1920.webp 1920w, /uploads/p/pixgamma/cli-dev-vi-dark-3840.webp 3840w" sizes="(max-width: 900px) 100vw, 760px" width="3840" height="2160" alt="Cho lập trình viên: lệnh pixgamma xử lý hàng loạt, báo cáo JSON, API cục bộ" loading="lazy" decoding="async" style="width:100%;height:auto;display:block;border:1px solid var(--line);border-radius:12px"></a><figcaption style="margin-top:8px;font-size:13px;line-height:1.5;color:var(--muted);text-align:center">Cho lập trình viên: lệnh pixgamma xử lý hàng loạt, báo cáo JSON, API cục bộ</figcaption></figure></div>

## Ví dụ

```bash
pixgamma upscale anh.jpg --scale 4
```

```bash
pixgamma upscale ~/Anh/san-pham -r -o ~/Anh/out -m std --scale 2 -f jpg --jq 92 --se
```

```bash
pixgamma upscale chan-dung.jpg -m rec --cr 75 --rs 40
```

```bash
pixgamma upscale anh.png --width 3000 --json
```

## Các cờ của `pixgamma upscale`

| Cờ | Ý nghĩa |
|---|---|
| `-m` | `auto` (mặc định), `std`, `hf`, `art`, `low`, `rec` |
| `--scale`, `--width`, `--height` | Kích thước đầu ra: tỉ lệ 1–16 hoặc số điểm ảnh (giữ tỉ lệ) |
| `--dn`, `--sh`, `--cm`, `--dh` | Khử nhiễu, làm nét, khử nén JPEG, khử viền sáng (0–100) |
| `--dt`, `--tx`, `--lc` | Detail (High Fidelity), kết cấu hạt, tương phản cục bộ (0–100) |
| `--fr`, `--frc`, `--frf` | Phục hồi khuôn mặt (0 = tắt), kiểu `realistic`/`creative`, mức giữ mặt gốc |
| `--cr`, `--rs`, `--prompt` | Recover: Creativity, Resemblance, prompt tiếng Anh |
| `--no-text-protect`, `--no-color-fix` | Tắt giữ chữ, tắt giữ màu gốc |
| `-f`, `--jq`, `--res` | Định dạng `preserve`/`png`/`jpg`/`tiff`/`heic`, chất lượng JPEG/HEIC, DPI |
| `-r`, `-o`, `--flatten` | Duyệt thư mục con, thư mục ra, không giữ cấu trúc thư mục con |
| `--prefix`, `--suffix`, `--am`, `--se` | Tiền tố, hậu tố, thêm tên model vào tên file, bỏ qua file đã có |
| `-d` | `gpu` (mặc định), `all`, `ane`, `cpu` |
| `--json`, `-q` | In báo cáo JSON, chạy im lặng |

Mặc định ảnh ra nằm cạnh ảnh gốc, thêm hậu tố `-pixgamma`; ảnh gốc không bao giờ bị ghi đè.

## Báo cáo JSON

`--json` in mỗi ảnh một mục: kích thước vào/ra, model đã chạy (`passes`), thời gian, số vùng chữ, chữ đọc được, số khuôn mặt đã phục hồi và kết quả phân tích của Auto (nhiễu, độ nét, độ nén, độ khối, mảng phẳng).

```json
{
  "inputSize": [480, 360], "outputSize": [1920, 1440],
  "mode": "standard", "passes": ["Photo"], "seconds": 12.6,
  "textRegions": 5, "text": ["MacBook Pro", "delete", "tab", "caps lock"]
}
```

## Lệnh khác

| Lệnh | Việc |
|---|---|
| `pixgamma analyze anh.jpg` | In thiết lập Auto đề xuất |
| `pixgamma models` | Liệt kê model và vị trí file |
| `pixgamma serve` | Mở API cục bộ, xem [API](https://phatdev.net/docs/pixgamma/api) |
| `pixgamma update` | Kiểm tra và cài bản mới |
| `pixgamma --version` | In phiên bản |