1import os, urllib.request
2from margen import Margen
3 
4client = Margen(bearer_auth="mgn_test_...")   # free test key from the portal
5 
6# The passport test set is a free sample: one real and one fake per demographic
7# cell, from both editors (see Benchmarks). Pull one HiDream fake:
8item = client.list_items(
9    benchmark="passport-pad-v1", kind="fake", generator="hidream_o1", limit=1,
10).result.data[0]
11 
12dl = client.download_item(item_id=item.id)   # test tier: free, no credit debited
13print("signed url:", dl.url)                 # click to open the image in a browser
14 
15out_dir = "margen_out"                        # <- change to any folder you like
16os.makedirs(out_dir, exist_ok=True)
17path = os.path.join(out_dir, f"{item.id}.jpg")
18urllib.request.urlretrieve(dl.url, path)      # signed URL, no auth header
19print("saved to:", path)