Spaces:
Sleeping
Sleeping
File size: 8,164 Bytes
97bb244 b8d2078 97bb244 b8d2078 97bb244 eacd242 97bb244 eacd242 97bb244 b8d2078 97bb244 b8d2078 97bb244 b8d2078 97bb244 b8d2078 97bb244 b8d2078 97bb244 b8d2078 97bb244 b8d2078 97bb244 | 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 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 | from __future__ import annotations
"""
调用 Hugging Face Spaces:wkea/blockdiffusion-api
用途:
- 以“伪私有”方式调用 Space(必须提供 SPACE_API_KEY)
- 传入 prompt / CFG / DDIM 等参数
- 将返回的 grid 与 gallery 图片保存到本地目录
说明:
- 本脚本优先使用 gradio_client(推荐且最稳定)
- 若你的环境缺少 gradio_client,请先安装后再运行(通常安装 gradio 时会自带)
"""
import argparse
import os
import shutil
from datetime import datetime
from pathlib import Path
from typing import Any, List, Tuple
DEFAULT_SPACE = "wkea/blockdiffusion-api"
DEFAULT_KEY_FILENAME = "space_api_key.txt"
def _now_tag() -> str:
return datetime.now().strftime("%Y%m%d-%H%M%S")
def _ensure_dir(p: str) -> str:
Path(p).mkdir(parents=True, exist_ok=True)
return p
def _script_dir() -> Path:
return Path(__file__).resolve().parent
def _read_text_first_line(path: Path) -> str:
try:
txt = path.read_text(encoding="utf-8", errors="ignore")
except Exception:
return ""
# 只取第一行,避免误把多行内容当作 key
return (txt.splitlines()[0].strip() if txt.splitlines() else "").strip()
def _resolve_api_key(arg_key: str) -> str:
"""
优先级:
1) 命令行 --api_key
2) 环境变量 SPACE_API_KEY(或 SPACEAPIKEY,兼容 Space 端命名限制)
3) 脚本同目录的 space_api_key.txt(仅为“直接运行”方便;注意不要提交到git)
"""
k = (arg_key or "").strip()
if k:
return k
k = (os.getenv("SPACE_API_KEY", "") or "").strip()
if not k:
k = (os.getenv("SPACEAPIKEY", "") or "").strip()
if k:
return k
kfile = _script_dir() / DEFAULT_KEY_FILENAME
if kfile.is_file():
return _read_text_first_line(kfile)
return ""
def _as_path(maybe_path: Any) -> str | None:
"""
gradio_client 的 Image/Gallery 返回值常见形式:
- 本地文件路径(str)
- {"path": "..."} / {"name": "..."} 之类的 dict
本函数尽量从这些结构中提取本地路径。
"""
if maybe_path is None:
return None
if isinstance(maybe_path, str):
return maybe_path
if isinstance(maybe_path, dict):
for k in ("path", "name", "file", "filepath"):
v = maybe_path.get(k, None)
if isinstance(v, str) and v:
return v
return None
def _save_one(src: Any, dst_path: str) -> str | None:
"""
把 gradio_client 返回的文件对象/路径落盘到 dst_path。
"""
sp = _as_path(src)
if not sp:
return None
if not os.path.isfile(sp):
return None
_ensure_dir(str(Path(dst_path).parent))
shutil.copyfile(sp, dst_path)
return dst_path
def _call_space(
space: str,
api_key: str,
prompt: str,
cfg_scale: float,
use_ema: bool,
use_ddim: bool,
ddim_steps: int,
ddim_eta: float,
n_images: int,
batch: int,
seed: int,
preview_upscale: int,
) -> Tuple[str, Any, List[Any]]:
"""
返回:(info_text, grid_obj, gallery_objs)
"""
try:
from gradio_client import Client # type: ignore
from gradio_client.exceptions import AppError # type: ignore
except Exception as e:
raise RuntimeError("缺少依赖:gradio_client(建议安装 gradio 时一并安装)") from e
# Space 是公开的,通常不需要 hf_token;仅当 Space 本身是私有才需要。
client = Client(space)
# 输入顺序必须与 Space 的 gradio inputs 一致(见 app.py run.click(inputs=...))
try:
res = client.predict(
api_key,
prompt,
float(cfg_scale),
bool(use_ema),
bool(use_ddim),
int(ddim_steps),
float(ddim_eta),
int(n_images),
int(batch),
int(seed),
int(preview_upscale),
fn_index=0,
)
except AppError as e:
# 让报错更可读:通常是 Space 端 gr.Error 抛出的信息
raise RuntimeError(f"Space调用失败:{e}") from e
# 期望输出:(info, grid, gallery)
if not isinstance(res, (list, tuple)) or len(res) != 3:
raise RuntimeError(f"Space返回结构异常:{type(res)} len={getattr(res, '__len__', lambda: 'NA')()}")
info, grid, gallery = res[0], res[1], res[2]
if not isinstance(gallery, list):
gallery = []
return str(info), grid, gallery
def parse_args() -> argparse.Namespace:
p = argparse.ArgumentParser(description="调用 Hugging Face Space:BlockDiffusion API(伪私有)")
p.add_argument("--space", type=str, default=DEFAULT_SPACE, help="Space 名称,例如 wkea/blockdiffusion-api")
p.add_argument(
"--api_key",
type=str,
default="",
help="伪私有 API_KEY(优先从环境变量 SPACE_API_KEY 或同目录 space_api_key.txt 读取)",
)
p.add_argument("--prompt", type=str, default="stone block texture", help="提示词(条件模型可用;留空=无条件)")
p.add_argument("--cfg_scale", type=float, default=3.0)
p.add_argument("--use_ema", action="store_true", help="使用 EMA 权重(推荐)")
p.add_argument("--no_use_ema", action="store_true", help="禁用 EMA(仅排查用)")
p.add_argument("--use_ddim", action="store_true", help="使用 DDIM(更快)")
p.add_argument("--no_use_ddim", action="store_true", help="禁用 DDIM(用 DDPM)")
p.add_argument("--ddim_steps", type=int, default=50)
p.add_argument("--ddim_eta", type=float, default=0.0)
p.add_argument("--n", type=int, default=1, help="生成张数(Space建议<=8)")
p.add_argument("--batch", type=int, default=1)
p.add_argument("--seed", type=int, default=123)
p.add_argument("--preview_upscale", type=int, default=16)
# 默认输出到脚本所在目录,方便“直接运行就有结果”
p.add_argument("--out_dir", type=str, default=".", help="输出目录(相对路径默认相对于脚本目录)")
return p.parse_args()
def main() -> None:
args = parse_args()
api_key = _resolve_api_key(args.api_key)
if not api_key:
raise RuntimeError(
f"缺少API_KEY:请设置环境变量 SPACE_API_KEY,或在脚本同目录创建 {DEFAULT_KEY_FILENAME}(第一行写入Key),或传入 --api_key"
)
use_ema = bool(args.use_ema) and (not bool(args.no_use_ema))
use_ddim = bool(args.use_ddim) and (not bool(args.no_use_ddim))
# 输出目录:相对路径按“脚本目录”解析,避免你在不同cwd运行导致输出位置乱跳
out_dir_p = Path(args.out_dir or ".")
if not out_dir_p.is_absolute():
out_dir_p = _script_dir() / out_dir_p
out_dir = _ensure_dir(str(out_dir_p))
tag = _now_tag()
info, grid, gallery = _call_space(
space=args.space,
api_key=api_key,
prompt=args.prompt,
cfg_scale=float(args.cfg_scale),
use_ema=use_ema,
use_ddim=use_ddim,
ddim_steps=int(args.ddim_steps),
ddim_eta=float(args.ddim_eta),
n_images=int(args.n),
batch=int(args.batch),
seed=int(args.seed),
preview_upscale=int(args.preview_upscale),
)
# 保存 info
info_path = os.path.join(out_dir, f"info_{tag}.txt")
Path(info_path).write_text(info, encoding="utf-8")
# 保存 grid
grid_path = os.path.join(out_dir, f"space_grid_{tag}.png")
_save_one(grid, grid_path)
# 保存 gallery(如果有)
saved = 0
for i, one in enumerate(gallery):
p = os.path.join(out_dir, f"space_img_{tag}_{i:02d}.png")
if _save_one(one, p):
saved += 1
print(f"[ok] out_dir={out_dir} grid={grid_path} gallery_saved={saved} info={info_path}")
if __name__ == "__main__":
main()
|