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()