ComfyUI Node
Gelbooru (Random)
A ComfyUI node in Gelbooru with 22 inputs and 8 outputs.
Gelbooru (Random)
- imgtags
- imgurl
- imgid
- width
- height
- source
- url
- IMAGE
◄use_custom_promptfalse►
◄site▾►
◄OR_tags►
◄AND_tags►
◄exclude_taganimated,►
◄remove_tagscensored, mosaic_censoring, bar_censor►
◄add_good_tagstrue►
◄remove_bad_tagstrue►
◄convert_underscorefalse►
◄change_backgroundDon't Change►
◄change_colorDon't Change►
◄Safetrue►
◄Questionabletrue►
◄Explicittrue►
◄score0►
◄api_credentials►
◄seed0►
◄count1►
◄use_last_promptDisabled►
◄return_picturefalse►
◄extra_text—►
◄custom_prompt—►
CategoryGelbooru
Inputs (22)
| Name | Type | Default | Description |
|---|---|---|---|
| use_custom_prompt | BOOLEAN | false | Enable custom prompt override - replaces imgtags entirely with custom_prompt input |
| site | COMBO | Image board to search: Gelbooru or Rule34 | |
| OR_tags | STRING | At least one of these tags must be present (broadens results). Example: blonde, red_hair finds images with EITHER blonde OR red_hair. Use when you want variants (hair colors, poses, outfits) in one search | |
| AND_tags | STRING | All of these tags must be present on the image (narrows results). Example: 1girl, smile finds images with BOTH 1girl AND smile | |
| exclude_tag | STRING | animated, | Tags to exclude from results (comma-separated) |
| remove_tags | STRING | censored, mosaic_censoring, bar_censor | Tags to remove from the output imgtags (comma-separated). Useful for filtering out unwanted tags from the result |
| add_good_tags | BOOLEAN | true | Prepend quality tags (masterpiece, best quality, etc.) from good_tags.txt |
| remove_bad_tags | BOOLEAN | true | Remove known bad tags (watermark, text, censored, etc.) loaded from bad_tags.txt |
| convert_underscore | BOOLEAN | false | Convert underscores to spaces in tags |
| change_background | COMBO | Don't Change | Add or remove background-related tags from the result |
| change_color | COMBO | Don't Change | Add or remove color-related tags from the result |
| Safe | BOOLEAN | true | Include Safe/General rated posts |
| Questionable | BOOLEAN | true | Include Questionable/Sensitive rated posts |
| Explicit | BOOLEAN | true | Include Explicit rated posts |
| score | INT | 00–18446744073709550000 | Minimum score threshold (0 = no filter) |
| api_credentials | STRING | API credentials in format: api_key=YOUR_KEY&user_id=YOUR_ID | |
| seed | INT | 00–18446744073709550000 | — |
| count | INT | 11–100 | Number of posts to fetch per request (max 100) |
| use_last_prompt | COMBO | Disabled | Disabled: fetch new results. Last Prompt: reuse previous API response. Previous Prompt: reuse the response before last. |
| return_picture | BOOLEAN | false | Download the first post's image and output as IMAGE tensor |
| extra_textopt | STRING | Generated text from another node, prepended before the final output (connect only, not editable) | |
| custom_promptopt | STRING | Completely replaces imgtags output when use_custom_prompt is enabled (connect only) |
Outputs (8)
| Name | Type | Description |
|---|---|---|
| imgtags | STRING | All tags of the fetched post(s), comma-separated |
| imgurl | STRING | Direct file URL(s) of the image(s) |
| imgid | STRING | Post ID(s) on the image board |
| width | INT | Width of the image(s) in pixels |
| height | INT | Height of the image(s) in pixels |
| source | STRING | Source website URL(s) of the post(s) |
| url | STRING | The full API query URL used for the request |
| IMAGE | IMAGE | Image tensor (only populated when return_picture is enabled) |