ComfyUI Node: Danbooru

Danbooru:

LPP_Danbooru is a node designed to interface with the Danbooru image board, allowing you to fetch and process image tags from the platform. This node is part of the Lazy Pony Prompter suite, which aims to streamline the process of gathering and utilizing image metadata for AI art generation. By connecting to Danbooru's API, LPP_Danbooru can retrieve tags associated with images, which can then be used to enhance your AI models' understanding of visual content. The node supports filtering and sorting options, enabling you to customize the data retrieval process according to your specific needs. This functionality is particularly beneficial for AI artists looking to incorporate detailed and contextually relevant tags into their creative workflows, thereby improving the quality and relevance of generated art.

Danbooru Input Parameters:

query

The query parameter is a string that specifies the search criteria for fetching image tags from Danbooru. It can be a direct image URL or a search query composed of tags. This parameter is crucial as it determines the scope and specificity of the data retrieved. There are no explicit minimum or maximum values, but the query should be valid and relevant to the Danbooru database.

count

The count parameter is an integer that defines the number of posts to retrieve from Danbooru. It impacts the volume of data processed and returned by the node. The maximum value is capped at 200 per page due to API limitations, but you can request more by fetching multiple pages. The default value is not specified, but it should be set according to your data needs.

rating

The rating parameter is an optional string that filters the results based on the content rating of the images. It helps in narrowing down the search to images that meet specific content criteria, such as safe, questionable, or explicit. The available options are determined by the Danbooru rating system, and the default is to include all ratings if not specified.

sort_type

The sort_type parameter is an optional string that determines the order in which the results are returned. It allows you to sort the images based on various criteria, such as popularity or upload date. The available options are defined by the Danbooru API, and the default behavior is to return results in the order they are retrieved if no sort type is specified.

Danbooru Output Parameters:

TagData

The TagData output parameter is a structured data object that contains the processed tags retrieved from Danbooru. It includes the source name, the query used, and a list of tag dictionaries for each post. This output is essential for integrating the retrieved tags into your AI art generation process, providing a rich set of metadata that can enhance the contextual understanding of visual content.

Danbooru Usage Tips:

• Use specific and well-defined queries to ensure that the tags retrieved are relevant and useful for your AI art projects.
• Adjust the count parameter to balance between the breadth of data and the performance of the node, especially when dealing with large datasets.
• Utilize the rating and sort_type parameters to filter and organize your results, making it easier to find the most relevant tags for your needs.

Danbooru Common Errors and Solutions:

Invalid query format

• Explanation: This error occurs when the query string is not formatted correctly or does not match the expected pattern for Danbooru searches.
• Solution: Ensure that your query is a valid Danbooru search string or a direct image URL. Refer to the Danbooru cheatsheet for proper query syntax.

API request limit exceeded

• Explanation: Danbooru imposes limits on the number of API requests that can be made in a given time frame.
• Solution: Reduce the frequency of your requests or implement a delay between requests to comply with Danbooru's rate limits.

No results found

• Explanation: The query did not match any posts on Danbooru, resulting in an empty response.
• Solution: Refine your query to use more common or broader tags, or verify that the tags you are using exist on Danbooru.