Comfyui2api/.env.example at main · Einzieg/Comfyui2api · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
### comfyui2api .env 模板
### 用途：
### - Docker Compose：会自动读取同目录的 .env 用于变量替换
### - 本机运行：你可以手动 `set`/`$env:`，或用 `uvicorn --env-file .env ...`

### API 服务监听
API_LISTEN=0.0.0.0
API_PORT=8000

### 可选：开启后所有接口需要 Authorization: Bearer <token>
API_TOKEN=

### 可选：用于生成对外可访问的输出 URL（例如放在反代后面时）
PUBLIC_BASE_URL=

### ComfyUI 地址（必须）
COMFYUI_BASE_URL=http://127.0.0.1:8188

### 启动时是否先检查 ComfyUI 可达性；为 false 时 API 可先启动，等 ComfyUI 稍后可用
COMFYUI_STARTUP_CHECK=true

### 工作流目录（ComfyUI File -> Export (API) 导出的 JSON）
WORKFLOWS_DIR=./comfyui-api-workflows

### 运行产物目录（任务输出会保存在 RUNS_DIR/<job_id>/）
RUNS_DIR=./runs

### 图片输入存储方式（图生图/图生视频）
### - comfy：通过 ComfyUI `POST /upload/image` 上传（推荐：ComfyUI 在 WSL / Docker / 远端时）
### - local：写入 COMFYUI_INPUT_DIR/<INPUT_SUBDIR>/ 下（需要 API 与 ComfyUI 共享磁盘）
### - auto：优先 comfy，失败再 fallback 到 local
IMAGE_UPLOAD_MODE=comfy

### 仅在 IMAGE_UPLOAD_MODE=local（或 auto fallback）时需要：
### 如果 ComfyUI 运行在 WSL，通常不需要设置这个路径，直接用 IMAGE_UPLOAD_MODE=comfy 即可
COMFYUI_INPUT_DIR=E:\\AI_Workstation\\ComfyUI_windows_portable\\ComfyUI\\input

### 写入 input 的子目录名（无论 upload 还是 local，都会用这个 subfolder）
INPUT_SUBDIR=comfyui2api

### Worker 并发（同时跑多少个任务；ComfyUI 本身也有队列）
WORKER_CONCURRENCY=1

### 已完成/失败任务的保留与清理策略
### - JOB_RETENTION_DAYS：按“天”配置任务在内存和 RUNS_DIR 中保留多久（优先级高于 JOB_RETENTION_SECONDS）
### - JOB_RETENTION_SECONDS：按“秒”配置任务在内存和 RUNS_DIR 中保留多久
### - MAX_JOBS_IN_MEMORY：最多保留多少个任务记录
### - JOB_CLEANUP_INTERVAL_S：后台清理扫描间隔
JOB_RETENTION_DAYS=
JOB_RETENTION_SECONDS=604800
MAX_JOBS_IN_MEMORY=1000
JOB_CLEANUP_INTERVAL_S=60

### 是否监听工作流目录变更并热加载
ENABLE_WORKFLOW_WATCH=true

### 请求/图片大小限制
MAX_BODY_BYTES=30000000
MAX_IMAGE_BYTES=20000000

### 执行超时/轮询参数（单位：秒）
TIMEOUT_S=3600
POLL_INTERVAL_S=0.5
HTTP_TIMEOUT_S=30

### 输出媒体下载链接的短期签名
### - SIGNED_URL_SECRET：留空时会回退为 API_TOKEN
### - SIGNED_URL_TTL_SECONDS：图片/视频 URL 有效期（秒）
SIGNED_URL_SECRET=
SIGNED_URL_TTL_SECONDS=3600

### 默认工作流（文件名需存在于 WORKFLOWS_DIR）
DEFAULT_TXT2IMG_WORKFLOW=文生图_z_image_turbo.json
DEFAULT_IMG2IMG_WORKFLOW=图生图_flux2.json
DEFAULT_TXT2VIDEO_WORKFLOW=
DEFAULT_IMG2VIDEO_WORKFLOW=img2video.json