Nodes/Phota API Nodes/Phota Profile Gallery
ComfyUI Node

Phota Profile Gallery

Every Phota profile you own, with faces, on one screen

By photalabs·Created 3 months ago·Updated 3 months ago· 0
Phota Profile Gallery
    • cover_photos
    • listing
    • count
    tag
    api_key

    A visual index of your identities

    Once you've trained a few Phota profiles, the raw IDs blur together. abc123 is your dog; def456 is… your other dog? A client? PhotaProfileGallery answers that by fetching every profile in your account with its cover photo, as an IMAGE batch you can drop straight into PreviewImage. The README calls the whole profile-management side of the pack "free to run" - no generation is billed here - which makes this the zero-cost way to keep tabs on what you own.

    How it works

    The node lists your profiles from the API (optionally filtered by tag) and fetches each READY profile's cover photo, stacking them into a single IMAGE tensor. Alongside the images it emits a listing string - one line per profile, pairing each cover with its ID, status, and tag - plus a count of profiles. The listing is what makes the batch legible: image n in the batch corresponds to line n in the listing, in the same order.

    Because profiles change server-side, the node always refetches on every run rather than reusing a cached result. Wire the cover_photos output into PreviewImage and the listing into a Show Text node and you've got a self-updating profile wall.

    The inputs

    This one has no required inputs at all.

    • tag - optional; only list profiles carrying this tag. Handy when you've got dozens and only want the client's batch.
    • api_key - leave empty to use PHOTA_API_KEY or phota.ini, as everywhere in this pack.

    Outputs

    • cover_photos - an IMAGE batch of cover photos (one per READY profile).
    • listing - the per-profile summary text: id [status] (tag).
    • count - how many profiles matched.

    Gotchas

    • Profiles still training have no cover photo yet. They appear in the listing and count, but not in the image batch - and if none of your profiles has a cover (say, everything is still VALIDATING), the node errors out while printing the listing so you can at least read who's where.
    • A profile with a failed cover fetch is skipped gracefully and marked "(no cover photo)" in the listing rather than killing the whole node.
    • If you're filtering by tag, tag on this node is a runtime widget - unlike the Profile Selector's dropdown, which is fixed at page load. That's the README's recommended way to filter at runtime.

    Install is the same as the rest of the pack: search Phota API Nodes in ComfyUI Manager, or git clone https://github.com/photalabs/comfyui-phota into custom_nodes and restart. Only dependency is requests; no GPU needed.

    CategoryPhota

    Inputs (2)

    NameTypeDefaultDescription
    tagoptSTRINGOnly list profiles with this tag.
    api_keyoptSTRINGLeave empty (recommended) to use the PHOTA_API_KEY environment variable or phota.ini. A key typed here is saved inside the workflow — do not share such workflows.

    Outputs (3)

    NameTypeDescription
    cover_photosIMAGE
    listingSTRING
    countINT