README.md

---
title: AI 圖片生成 API
emoji: 🖼️
colorFrom: blue
colorTo: purple
sdk: docker
app_port: 7860
---

# AI 圖片生成 API + 試玩站

部署在 Hugging Face Spaces 的圖片生成服務，整合 FLUX、Z-Image、Hunyuan 等模型。

## 🌟 功能特性

- **Web UI 試玩**: 直覺的圖片生成介面
- **REST API**: 標準 HTTP API，回傳 Base64 圖片
- **API Key 驗證**: 內建 API Key 機制
- **多模型支援**: FLUX.1-schnell、Z-Image、Hunyuan-3.0

## 🔧 環境變數

在 Space Settings > Variables and Secrets 設定：

| 變數 | 說明 | 預設值 |
|------|------|--------|
| `HF_TOKEN` | Hugging Face Token | 空 |
| `PUBLIC_API_KEY` | 公開 API Key | `demo-key-123456` |
| `SPACE_URL` | Space 完整 URL | 自動偵測 |

## 📡 API 使用

### 端點