#!/usr/bin/env python3 """Call the faceswap-lissie RunPod serverless endpoint SYNCHRONOUSLY (/runsync). Standalone: python 3.8+, stdlib only. Flux-2-Klein head/face swap (workflow new-faceswap-lissie-v4): puts the head from --face-image onto the body/scene of --body-image. python faceswap_lissie_sync.py \ --api-key $RUNPOD_API_KEY \ --body-image scene.jpg --face-image face.jpg \ --out ./results All arguments: --api-key RunPod API key (or set RUNPOD_API_KEY) --endpoint-id RunPod endpoint id (default: ENDPOINT_DEFAULT below) --body-image image supplying body/scene/pose (required) --face-image image supplying the head/face (required) --instruction head-swap instruction text (sane default baked in) --expression-prompt what the QwenVL captioner is asked about the face --negative-prompt negative conditioning text --steps sampler steps (default 5) --cfg guidance (default 1.0) --seed integer seed (default: random, printed back) --rmbg-sensitivity / --rmbg-process-res background-removal tuning --workflow baked workflow name (default new-faceswap-lissie-v4) --set NODE.INPUT=VALUE raw graph override, repeatable --workflow-json FILE full API-format graph passthrough --out output directory (default .) --timeout max seconds (default 600) """ import argparse import base64 import json import os import pathlib import sys import time import urllib.error import urllib.request DEFAULT_ENDPOINT = "qkeibkeoefcrk3" def main(): ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter) ap.add_argument("--api-key", default=os.environ.get("RUNPOD_API_KEY")) ap.add_argument("--endpoint-id", default=DEFAULT_ENDPOINT) ap.add_argument("--body-image", required=True) ap.add_argument("--face-image", required=True) ap.add_argument("--instruction") ap.add_argument("--expression-prompt") ap.add_argument("--negative-prompt") ap.add_argument("--steps", type=int) ap.add_argument("--cfg", type=float) ap.add_argument("--seed", type=int) ap.add_argument("--rmbg-sensitivity", type=float) ap.add_argument("--rmbg-process-res", type=int) ap.add_argument("--workflow") ap.add_argument("--set", action="append", metavar="NODE.INPUT=VALUE") ap.add_argument("--workflow-json") ap.add_argument("--out", default=".") ap.add_argument("--timeout", type=float, default=600) args = ap.parse_args() if not args.api_key: sys.exit("ERROR: pass --api-key or set RUNPOD_API_KEY") params = {"body_image": os.path.basename(args.body_image), "face_image": os.path.basename(args.face_image)} for cli, p in [("instruction", "instruction"), ("expression_prompt", "expression_prompt"), ("negative_prompt", "negative_prompt"), ("steps", "steps"), ("cfg", "cfg"), ("seed", "seed"), ("rmbg_sensitivity", "rmbg_sensitivity"), ("rmbg_process_res", "rmbg_process_res")]: v = getattr(args, cli) if v is not None: params[p] = v payload = { "images": [ {"name": os.path.basename(args.body_image), "image": base64.b64encode(open(args.body_image, "rb").read()).decode()}, {"name": os.path.basename(args.face_image), "image": base64.b64encode(open(args.face_image, "rb").read()).decode()}, ], "params": params, } if args.workflow: payload["workflow"] = args.workflow if args.workflow_json: payload["workflow_json"] = json.load(open(args.workflow_json)) overrides = {} for s in args.set or []: k, v = s.split("=", 1) try: overrides[k] = json.loads(v) except json.JSONDecodeError: overrides[k] = v if overrides: payload["set"] = overrides req = urllib.request.Request( f"https://api.runpod.ai/v2/{args.endpoint_id}/runsync", data=json.dumps({"input": payload}).encode(), headers={"Content-Type": "application/json", "Authorization": f"Bearer {args.api_key}"}) t0 = time.monotonic() try: with urllib.request.urlopen(req, timeout=args.timeout) as r: result = json.load(r) except urllib.error.HTTPError as e: sys.exit(f"ERROR: HTTP {e.code}: {e.read().decode(errors='replace')[:2000]}") # /runsync answers early (IN_QUEUE/IN_PROGRESS) when a job outlives the # sync window (~90 s), e.g. during a cold start — fall back to polling TERMINAL = ("COMPLETED", "FAILED", "CANCELLED", "TIMED_OUT") while result.get("status") not in TERMINAL and result.get("id"): if time.monotonic() - t0 > args.timeout: sys.exit(f"ERROR: timed out after {args.timeout}s " f"(job {result['id']} status {result.get('status')})") time.sleep(3) poll = urllib.request.Request( f"https://api.runpod.ai/v2/{args.endpoint_id}/status/{result['id']}", headers={"Authorization": f"Bearer {args.api_key}"}) with urllib.request.urlopen(poll, timeout=90) as r: result = json.load(r) if result.get("status") != "COMPLETED": sys.exit(f"ERROR: {json.dumps(result, indent=2)[:3000]}") output = result["output"] if "error" in output: sys.exit(f"ERROR from handler: {output['error']}") out_dir = pathlib.Path(args.out) out_dir.mkdir(parents=True, exist_ok=True) for i, img in enumerate(output["images"]): p = out_dir / f"{int(time.time())}-{i}-{img['filename']}" p.write_bytes(base64.b64decode(img["data"])) print(p) print(f"# seed={output.get('seed')} wall={time.monotonic()-t0:.1f}s " f"delay={result.get('delayTime')}ms exec={result.get('executionTime')}ms", file=sys.stderr) if __name__ == "__main__": main()