refactor: OpenAI-only /v1 API

Author: WuMingDao

README.md

@@ -21,16 +21,14 @@ batch generation, and one-click deployment to Cloudflare Pages.
 ## Features
 
 - **Multiple AI Providers** - Gitee AI, HuggingFace Spaces, ModelScope
-- **Image-to-Video** - Generate videos from images (Gitee AI)
 - **Dark Mode UI** - Gradio-style with frosted glass effects
 - **Flexible Sizing** - Multiple aspect ratios (1:1, 16:9, 9:16, 4:3, etc.)
-- **4x Upscaling** - RealESRGAN integration
 - **Secure Storage** - API keys encrypted with AES-256-GCM
 - **Token Rotation** - Multiple API keys with automatic failover on rate limits
 - **History (Lightweight)** - Stores metadata (URL + params) in localStorage with 24h TTL
 - **Flow Mode** - Visual canvas for batch generation (experimental)
   - Images are referenced by remote URLs (no blob caching)
-  - Flow state is persisted locally; downloads use a proxy endpoint for CORS-safe fetches
+  - Flow state is persisted locally
 
 ## Token Rotation
 
@@ -92,20 +90,30 @@ Open `http://localhost:5173`
 
 ## API Usage
 
-After deployment, you can call the API directly:
+After deployment, you can call the OpenAI-format API directly:
 
 ```bash
-curl -X POST https://your-project.pages.dev/api/generate \
+curl -X POST https://your-project.pages.dev/v1/images/generations \
   -H "Content-Type: application/json" \
-  -H "X-API-Key: your-gitee-api-key" \
-  -d '{"prompt": "a cute cat", "width": 1024, "height": 1024}'
+  -H "Authorization: Bearer gitee:your-gitee-api-key" \
+  -d '{
+    "model": "gitee/z-image-turbo",
+    "prompt": "a cute cat",
+    "size": "1024x1024",
+    "steps": 9,
+    "n": 1,
+    "response_format": "url"
+  }'
 ```
 
 Notes:
 
 - The API returns the **raw provider image URL** (e.g. HuggingFace Space `gradio_api/file=...`).
 - Some provider URLs are **temporary** (HF Space files often expire around 24 hours).
-- For CORS-safe downloads, use the built-in proxy endpoint: `GET /api/proxy-image?url=...`.
+- Provider routing is via the `model` prefix:
+  - `gitee/...` -> Gitee AI (`Authorization: Bearer gitee:...`)
+  - `ms/...` -> ModelScope (`Authorization: Bearer ms:...`)
+  - no prefix -> HuggingFace (token optional; `Authorization: Bearer <token>` or `Authorization: Bearer hf:<token>`)
 
 📖 **[Full API Reference](./docs/en/API.md)** - Providers, parameters, code examples
 

README.zh.md

@@ -21,10 +21,8 @@
 ## 功能特性
 
 - **多 AI 提供商** - Gitee AI、HuggingFace Spaces、ModelScope
-- **图片转视频** - 从图片生成视频 (Gitee AI)
 - **深色模式 UI** - Gradio 风格毛玻璃效果
 - **灵活尺寸** - 多种宽高比 (1:1, 16:9, 9:16, 4:3 等)
-- **4x 放大** - RealESRGAN 集成
 - **安全存储** - API Key 使用 AES-256-GCM 加密
 - **Token 轮询** - 多 API Key 自动切换，遇到限流自动换用下一个
 - **历史记录（轻量）** - 仅存元数据（URL + 参数）到 localStorage，24 小时自动过期清理
@@ -98,7 +96,31 @@ pnpm dev:web
 
 - 接口返回的是**原始图片 URL**（例如 HuggingFace Space 的 `gradio_api/file=...`）。
 - 部分 URL 是**临时文件**（HF Space 通常 24 小时左右会失效）。
-- 如需绕过 CORS 下载，可使用代理接口：`GET /api/proxy-image?url=...`。
+
+## API 使用
+
+部署后可直接调用 OpenAI 格式 API：
+
+```bash
+curl -X POST https://your-project.pages.dev/v1/images/generations \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer gitee:your-gitee-api-key" \
+  -d '{
+    "model": "gitee/z-image-turbo",
+    "prompt": "a cute cat",
+    "size": "1024x1024",
+    "steps": 9,
+    "n": 1,
+    "response_format": "url"
+  }'
+```
+
+说明：
+
+- Provider 路由通过 `model` 前缀区分：
+  - `gitee/...` -> Gitee AI（`Authorization: Bearer gitee:...`）
+  - `ms/...` -> ModelScope（`Authorization: Bearer ms:...`）
+  - 无前缀 -> HuggingFace（可选 token；`Authorization: Bearer <token>` 或 `Authorization: Bearer hf:<token>`）
 
 ## 安全性