Shuiwu Zhu commited on
Commit
38f60f7
·
2 Parent(s): e4e1a73 f5ff0a2

merge HF Space initial commit

Browse files
Files changed (2) hide show
  1. .gitattributes +35 -0
  2. README.md +7 -270
.gitattributes ADDED
@@ -0,0 +1,35 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ *.7z filter=lfs diff=lfs merge=lfs -text
2
+ *.arrow filter=lfs diff=lfs merge=lfs -text
3
+ *.bin filter=lfs diff=lfs merge=lfs -text
4
+ *.bz2 filter=lfs diff=lfs merge=lfs -text
5
+ *.ckpt filter=lfs diff=lfs merge=lfs -text
6
+ *.ftz filter=lfs diff=lfs merge=lfs -text
7
+ *.gz filter=lfs diff=lfs merge=lfs -text
8
+ *.h5 filter=lfs diff=lfs merge=lfs -text
9
+ *.joblib filter=lfs diff=lfs merge=lfs -text
10
+ *.lfs.* filter=lfs diff=lfs merge=lfs -text
11
+ *.mlmodel filter=lfs diff=lfs merge=lfs -text
12
+ *.model filter=lfs diff=lfs merge=lfs -text
13
+ *.msgpack filter=lfs diff=lfs merge=lfs -text
14
+ *.npy filter=lfs diff=lfs merge=lfs -text
15
+ *.npz filter=lfs diff=lfs merge=lfs -text
16
+ *.onnx filter=lfs diff=lfs merge=lfs -text
17
+ *.ot filter=lfs diff=lfs merge=lfs -text
18
+ *.parquet filter=lfs diff=lfs merge=lfs -text
19
+ *.pb filter=lfs diff=lfs merge=lfs -text
20
+ *.pickle filter=lfs diff=lfs merge=lfs -text
21
+ *.pkl filter=lfs diff=lfs merge=lfs -text
22
+ *.pt filter=lfs diff=lfs merge=lfs -text
23
+ *.pth filter=lfs diff=lfs merge=lfs -text
24
+ *.rar filter=lfs diff=lfs merge=lfs -text
25
+ *.safetensors filter=lfs diff=lfs merge=lfs -text
26
+ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
27
+ *.tar.* filter=lfs diff=lfs merge=lfs -text
28
+ *.tar filter=lfs diff=lfs merge=lfs -text
29
+ *.tflite filter=lfs diff=lfs merge=lfs -text
30
+ *.tgz filter=lfs diff=lfs merge=lfs -text
31
+ *.wasm filter=lfs diff=lfs merge=lfs -text
32
+ *.xz filter=lfs diff=lfs merge=lfs -text
33
+ *.zip filter=lfs diff=lfs merge=lfs -text
34
+ *.zst filter=lfs diff=lfs merge=lfs -text
35
+ *tfevents* filter=lfs diff=lfs merge=lfs -text
README.md CHANGED
@@ -1,273 +1,10 @@
1
- # Flow2API
2
-
3
- <div align="center">
4
-
5
- [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
6
- [![Python](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/)
7
- [![FastAPI](https://img.shields.io/badge/fastapi-0.119.0-green.svg)](https://fastapi.tiangolo.com/)
8
- [![Docker](https://img.shields.io/badge/docker-supported-blue.svg)](https://www.docker.com/)
9
-
10
- **一个功能完整的 OpenAI 兼容 API 服务,为 Flow 提供统一的接口**
11
-
12
- </div>
13
-
14
- ## ✨ 核心特性
15
-
16
- - 🎨 **文生图** / **图生图**
17
- - 🎬 **文生视频** / **图生视频**
18
- - 🎞️ **首尾帧视频**
19
- - 🔄 **AT/ST自动刷新** - AT 过期自动刷新,ST 过期时自动通过浏览器更新(personal 模式)
20
- - 📊 **余额显示** - 实时查询和显示 VideoFX Credits
21
- - 🚀 **负载均衡** - 多 Token 轮询和并发控制
22
- - 🌐 **代理支持** - 支持 HTTP/SOCKS5 代理
23
- - 📱 **Web 管理界面** - 直观的 Token 和配置管理
24
- - 🎨 **图片生成连续对话**
25
-
26
- ## 🚀 快速开始
27
-
28
- ### 前置要求
29
-
30
- - Docker 和 Docker Compose(推荐)
31
- - 或 Python 3.8+
32
-
33
- - 由于Flow增加了额外的验证码,你可以自行选择使用浏览器打码或第三发打码:
34
- 注册[YesCaptcha](https://yescaptcha.com/i/13Xd8K)并获取api key,将其填入系统配置页面```YesCaptcha API密钥```区域
35
-
36
- - 自动更新st浏览器拓展:[Flow2API-Token-Updater](https://github.com/TheSmallHanCat/Flow2API-Token-Updater)
37
-
38
- ### 方式一:Docker 部署(推荐)
39
-
40
- #### 标准模式(不使用代理)
41
-
42
- ```bash
43
- # 克隆项目
44
- git clone https://github.com/TheSmallHanCat/flow2api.git
45
- cd flow2api
46
-
47
- # 启动服务
48
- docker-compose up -d
49
-
50
- # 查看日志
51
- docker-compose logs -f
52
- ```
53
-
54
- #### WARP 模式(使用代理)
55
-
56
- ```bash
57
- # 使用 WARP 代理启动
58
- docker-compose -f docker-compose.warp.yml up -d
59
-
60
- # 查看日志
61
- docker-compose -f docker-compose.warp.yml logs -f
62
- ```
63
-
64
- ### 方式二:本地部署
65
-
66
- ```bash
67
- # 克隆项目
68
- git clone https://github.com/TheSmallHanCat/flow2api.git
69
- cd sora2api
70
-
71
- # 创建虚拟环境
72
- python -m venv venv
73
-
74
- # 激活虚拟环境
75
- # Windows
76
- venv\Scripts\activate
77
- # Linux/Mac
78
- source venv/bin/activate
79
-
80
- # 安装依赖
81
- pip install -r requirements.txt
82
-
83
- # 启动服务
84
- python main.py
85
- ```
86
-
87
- ### 首次访问
88
-
89
- 服务启动后,访问管理后台: **http://localhost:8000**,首次登录后请立即修改密码!
90
-
91
- - **用户名**: `admin`
92
- - **密码**: `admin`
93
-
94
- ## 📋 支持的模型
95
-
96
- ### 图片生成
97
-
98
- | 模型名称 | 说明| 尺寸 |
99
- |---------|--------|--------|
100
- | `gemini-2.5-flash-image-landscape` | 图/文生图 | 横屏 |
101
- | `gemini-2.5-flash-image-portrait` | 图/文生图 | 竖屏 |
102
- | `gemini-3.0-pro-image-landscape` | 图/文生图 | 横屏 |
103
- | `gemini-3.0-pro-image-portrait` | 图/文生图 | 竖屏 |
104
- | `imagen-4.0-generate-preview-landscape` | 图/文生图 | 横屏 |
105
- | `imagen-4.0-generate-preview-portrait` | 图/文生图 | 竖屏 |
106
-
107
- ### 视频生成
108
-
109
- #### 文生视频 (T2V - Text to Video)
110
- ⚠️ **不支持上传图片**
111
-
112
- | 模型名称 | 说明| 尺寸 |
113
- |---------|---------|--------|
114
- | `veo_3_1_t2v_fast_portrait` | 文生视频 | 竖屏 |
115
- | `veo_3_1_t2v_fast_landscape` | 文生视频 | 横屏 |
116
- | `veo_2_1_fast_d_15_t2v_portrait` | 文生视频 | 竖屏 |
117
- | `veo_2_1_fast_d_15_t2v_landscape` | 文生视频 | 横屏 |
118
- | `veo_2_0_t2v_portrait` | 文生视频 | 竖屏 |
119
- | `veo_2_0_t2v_landscape` | 文生视频 | 横屏 |
120
-
121
- #### 首尾帧模型 (I2V - Image to Video)
122
- 📸 **支持1-2张图片:1张作为首帧,2张作为首尾帧**
123
-
124
- > 💡 **自动适配**:系统会根据图片数量自动选择对应的 model_key
125
- > - **单帧模式**(1张图):使用首帧生成视频
126
- > - **双帧模式**(2张图):使用首帧+尾帧生成过渡视频
127
-
128
- | 模型名称 | 说明| 尺寸 |
129
- |---------|---------|--------|
130
- | `veo_3_1_i2v_s_fast_fl_portrait` | 图生视频 | 竖屏 |
131
- | `veo_3_1_i2v_s_fast_fl_landscape` | 图生视频 | 横屏 |
132
- | `veo_2_1_fast_d_15_i2v_portrait` | 图生视频 | 竖屏 |
133
- | `veo_2_1_fast_d_15_i2v_landscape` | 图生视频 | 横屏 |
134
- | `veo_2_0_i2v_portrait` | 图生视频 | 竖屏 |
135
- | `veo_2_0_i2v_landscape` | 图生视频 | 横屏 |
136
-
137
- #### 多图生成 (R2V - Reference Images to Video)
138
- 🖼️ **支持多张图片**
139
-
140
- | 模型名称 | 说明| 尺寸 |
141
- |---------|---------|--------|
142
- | `veo_3_0_r2v_fast_portrait` | 图生视频 | 竖屏 |
143
- | `veo_3_0_r2v_fast_landscape` | 图生视频 | 横屏 |
144
-
145
- ## 📡 API 使用示例(需要使用流式)
146
-
147
- ### 文生图
148
-
149
- ```bash
150
- curl -X POST "http://localhost:8000/v1/chat/completions" \
151
- -H "Authorization: Bearer han1234" \
152
- -H "Content-Type: application/json" \
153
- -d '{
154
- "model": "gemini-2.5-flash-image-landscape",
155
- "messages": [
156
- {
157
- "role": "user",
158
- "content": "一只可爱的猫咪在花园里玩耍"
159
- }
160
- ],
161
- "stream": true
162
- }'
163
- ```
164
-
165
- ### 图生图
166
-
167
- ```bash
168
- curl -X POST "http://localhost:8000/v1/chat/completions" \
169
- -H "Authorization: Bearer han1234" \
170
- -H "Content-Type: application/json" \
171
- -d '{
172
- "model": "imagen-4.0-generate-preview-landscape",
173
- "messages": [
174
- {
175
- "role": "user",
176
- "content": [
177
- {
178
- "type": "text",
179
- "text": "将这张图片变成水彩画风格"
180
- },
181
- {
182
- "type": "image_url",
183
- "image_url": {
184
- "url": "data:image/jpeg;base64,<base64_encoded_image>"
185
- }
186
- }
187
- ]
188
- }
189
- ],
190
- "stream": true
191
- }'
192
- ```
193
-
194
- ### 文生视频
195
-
196
- ```bash
197
- curl -X POST "http://localhost:8000/v1/chat/completions" \
198
- -H "Authorization: Bearer han1234" \
199
- -H "Content-Type: application/json" \
200
- -d '{
201
- "model": "veo_3_1_t2v_fast_landscape",
202
- "messages": [
203
- {
204
- "role": "user",
205
- "content": "一只小猫在草地上追逐蝴蝶"
206
- }
207
- ],
208
- "stream": true
209
- }'
210
- ```
211
-
212
- ### 首尾帧生成视频
213
-
214
- ```bash
215
- curl -X POST "http://localhost:8000/v1/chat/completions" \
216
- -H "Authorization: Bearer han1234" \
217
- -H "Content-Type: application/json" \
218
- -d '{
219
- "model": "veo_3_1_i2v_s_fast_fl_landscape",
220
- "messages": [
221
- {
222
- "role": "user",
223
- "content": [
224
- {
225
- "type": "text",
226
- "text": "从第一张图过渡到第二张图"
227
- },
228
- {
229
- "type": "image_url",
230
- "image_url": {
231
- "url": "data:image/jpeg;base64,<首帧base64>"
232
- }
233
- },
234
- {
235
- "type": "image_url",
236
- "image_url": {
237
- "url": "data:image/jpeg;base64,<尾帧base64>"
238
- }
239
- }
240
- ]
241
- }
242
- ],
243
- "stream": true
244
- }'
245
- ```
246
-
247
  ---
248
-
249
- ## 📄 许可证
250
-
251
- 本项目采用 MIT 许可证。详见 [LICENSE](LICENSE) 文件。
252
-
 
253
  ---
254
 
255
- ## 🙏 致谢
256
-
257
- - [PearNoDec](https://github.com/PearNoDec) 提供的YesCaptcha打码方案
258
- - [raomaiping](https://github.com/raomaiping) 提供的无头打码方案
259
- 感谢所有贡献者和使用者的支持!
260
-
261
- ---
262
-
263
- ## 📞 联系方式
264
-
265
- - 提交 Issue:[GitHub Issues](https://github.com/TheSmallHanCat/flow2api/issues)
266
-
267
- ---
268
-
269
- **⭐ 如果这个项目对你有帮助,请给个 Star!**
270
-
271
- ## Star History
272
-
273
- [![Star History Chart](https://api.star-history.com/svg?repos=TheSmallHanCat/flow2api&type=date&legend=top-left)](https://www.star-history.com/#TheSmallHanCat/flow2api&type=date&legend=top-left)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
  ---
2
+ title: Flow2api
3
+ emoji: 📚
4
+ colorFrom: red
5
+ colorTo: green
6
+ sdk: docker
7
+ pinned: false
8
  ---
9
 
10
+ Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference