ComfyUI Node: Civitai Model Selector

Civitai Model Selector:

CivitaiModelSelector is a node designed to facilitate the selection and downloading of AI models from the Civitai platform, which is a repository for various AI models. This node is particularly useful for AI artists who want to explore and utilize different models without manually navigating through the Civitai website. By integrating directly with Civitai, the node allows you to specify a model's AIR (Artificial Intelligence Resource) and automatically handles the authentication and downloading process. This streamlines the workflow, enabling you to focus more on creative tasks rather than the technicalities of model management. The node ensures that you have access to the latest models and updates, enhancing your ability to experiment with different AI capabilities and achieve desired artistic outcomes.

Civitai Model Selector Input Parameters:

air

The air parameter is a string that represents the Artificial Intelligence Resource identifier for the model you wish to select from Civitai. It is crucial for specifying which model to download and use. If this parameter is not set, the node will raise an error, prompting you to select a model using the Browse Civitai button. There are no specific minimum or maximum values for this parameter, but it must be a valid identifier corresponding to a model on Civitai.

api_config

The api_config parameter is an optional configuration that contains authentication details for accessing Civitai. It typically includes an API token, which can be provided directly or retrieved from the environment variable CIVITAI_API_TOKEN. If no token is provided, the node attempts to obtain a valid access token using OAuth, although public models do not require authentication. This parameter ensures secure and authenticated access to private models on Civitai.

prompt

The prompt parameter is an optional string that can be used to influence the selection process of the model. It is not mandatory, and its primary function is to provide additional context or criteria for model selection. The exact impact of this parameter depends on the implementation details of the node, which are not fully detailed in the provided context.

unique_id

The unique_id parameter is an optional identifier that helps in managing and distinguishing between different model selections or downloads. It is particularly useful in scenarios where multiple models are being handled simultaneously, ensuring that each model's data is correctly associated with its respective process.

Civitai Model Selector Output Parameters:

air

The air output parameter returns the same Artificial Intelligence Resource identifier that was input, confirming the model that has been selected and processed. This output is useful for verification and logging purposes, ensuring that the correct model has been handled.

path

The path output parameter provides the folder-relative name of the downloaded model. This is the path where the model file is stored locally after being downloaded from Civitai. It is essential for subsequent processes that require access to the model file, such as loading the model into an AI application or framework.

Civitai Model Selector Usage Tips:

• Ensure that the air parameter is correctly set to a valid model identifier from Civitai to avoid errors during the selection process.
• Utilize the api_config parameter to provide authentication details if you need access to private models, ensuring a seamless and secure connection to Civitai.
• Use the unique_id parameter to manage multiple model downloads effectively, preventing any mix-up between different models.

Civitai Model Selector Common Errors and Solutions:

No model AIR set — use the Browse Civitai button to pick one.

• Explanation: This error occurs when the air parameter is not set, meaning no model has been specified for selection.
• Solution: Use the Browse Civitai button to select a model and ensure that the air parameter is correctly populated with the model's identifier.

Authentication failed due to missing API token.

• Explanation: This error indicates that the node attempted to access a private model without the necessary authentication token.
• Solution: Provide a valid API token in the api_config parameter or ensure that the CIVITAI_API_TOKEN environment variable is set with the correct token.