# 圖片參數

本頁列出 `GET /c/img/{path}` 支援的 query 參數、預設值與優先順序。

## 參數

| 參數 | 別名 | 值 | 預設 | 說明 |
|---|---|---|---|---|
| `o` | `origin` | `1` | — | 回傳原檔，忽略其他所有參數 |
| `s` | `size` | 整數（px） | — | 短邊長度，等比例縮放 |
| `w` | `width` | 整數（px） | — | 寬度 |
| `h` | `height` | 整數（px） | — | 高度 |
| `q` | `quality` | `0`–`100` | WebP／JPG `75`、AVIF `50` | 輸出品質；PNG 不使用 |
| `t` | `type` | `webp`／`avif`／`jpg`／`jpeg`／`png` | `webp` | 輸出格式；其他值視為 `webp` |
| `d` | `dark` | `1`／`0` | `0` | 找不到圖片時回傳的 404 圖配色 |

短名與別名同時出現時取短名（`?s=200&size=400` 取 `200`）。

## 優先順序

| 順序 | 條件 | 結果 |
|---|---|---|
| 1 | 副檔名 `.pdf`／`.svg` | 直接串流原檔，所有參數無效 |
| 2 | `o=1` | 直接串流原檔 |
| 3 | 有 `s` | 依短邊縮放，忽略 `w`／`h` |
| 4 | 同時有 `w` 與 `h` | 裁切至該尺寸 |
| 5 | 只有 `w` 或 `h` | 依該邊等比例縮放 |
| 6 | 皆無 | 短邊超過 1024px 時長邊縮至 1024px |

各情境的尺寸計算見 [尺寸規則](/zh/api-reference-sizing)。

## 範例

```bash
# 短邊 480px、品質 60、AVIF
curl -fsS -o a.avif "http://localhost:8080/c/img/blog/a.jpg?s=480&q=60&t=avif"

# 裁切為 400x400 的 JPG
curl -fsS -o a.jpg "http://localhost:8080/c/img/blog/a.jpg?w=400&h=400&t=jpg"

# 原檔
curl -fsS -o origin.jpg "http://localhost:8080/c/img/blog/a.jpg?o=1"

# 不存在的圖片，取得深色 404 圖
curl -fsS -o missing.svg "http://localhost:8080/c/img/blog/none.jpg?d=1"
```