> ## Documentation Index
> Fetch the complete documentation index at: https://imageflowdoc.sakiko.de/llms.txt
> Use this file to discover all available pages before exploring further.

# ImageFlow 简介

> 高效、智能的图像管理与分发系统

## ImageFlow 是什么？

ImageFlow 是为现代网站与应用打造的高效图像服务系统。它会根据设备与浏览器能力自动选择最合适的尺寸与格式（如 WebP/AVIF），并提供简单易用的上传、管理与分发能力，显著提升加载性能与用户体验。

<Info>
  本站提供中英文文档：

  * 中文入口：<a href="/imageflow/zh/overview">项目介绍</a>｜<a href="/imageflow/zh/quickstart">快速开始</a>
  * English: <a href="/imageflow/en/overview">Overview</a> ｜ <a href="/imageflow/en/quickstart">Quickstart</a>

  代码仓库：<a href="https://github.com/Yuri-NagaSaki/ImageFlow" target="_blank">GitHub</a>
</Info>

## ✨ 核心特性

* API 密钥认证：保护上传与管理接口的安全
* 自适应分发：按设备类型（桌面/移动）智能选择横/竖图
* 现代格式：自动协商并返回 WebP 或 AVIF
* 过期清理：支持为图片设置过期时间（本地/S3 兼容存储）
* 简洁 API：通过简单接口获取随机图片，支持标签过滤
* 友好上传：拖拽上传、暗黑模式、实时预览与标签管理
* 后台处理：上传后自动检测方向与多格式转换，异步不阻塞

## 🚀 快速上手

<CardGroup cols={2}>
  <Card title="中文 · 快速开始" icon="rocket" href="/imageflow/zh/quickstart">
    本地运行与基础配置，三步即可上手。
  </Card>

  <Card title="English · Quickstart" icon="rocket" href="/imageflow/en/quickstart">
    Run locally and configure in minutes.
  </Card>
</CardGroup>

## 📚 文档导航

<Columns cols={2}>
  <Card title="中文 · 项目介绍" icon="book" href="/imageflow/zh/overview">
    总览与特性说明，了解 ImageFlow 能力与场景。
  </Card>

  <Card title="English · Overview" icon="book" href="/imageflow/en/overview">
    High-level overview, features and use cases.
  </Card>

  <Card title="中文 · 配置指南" icon="sliders" href="/imageflow/zh/configuration">
    存储、鉴权、格式与性能等关键配置说明。
  </Card>

  <Card title="English · Configuration" icon="sliders" href="/imageflow/en/configuration">
    Configure storage, auth, formats and performance.
  </Card>

  <Card title="中文 · 迁移指南" icon="shuffle" href="/imageflow/zh/migration">
    从现有图像服务平滑迁移到 ImageFlow。
  </Card>

  <Card title="English · Migration" icon="shuffle" href="/imageflow/en/migration">
    Migrate smoothly from existing setups.
  </Card>
</Columns>

## 🧩 API 参考

<Columns cols={2}>
  <Card title="中文 · 随机图片 API" icon="code" href="/imageflow/zh/api/random">
    `GET /api/random`，支持标签、方向、格式等筛选。
  </Card>

  <Card title="English · Random Image API" icon="code" href="/imageflow/en/api/random">
    `GET /api/random` with tags/orientation/format filters.
  </Card>
</Columns>

<Note>
  提示：主页仅作为总览与导航。请根据你的语言偏好进入对应文档获得完整说明与示例。
  如发现链接或内容问题，欢迎在 GitHub 提交 Issue 或 PR。
</Note>