Articles on: Artwork

How To Use AI Filter Feature

Customall provides an AI Filter feature that allows you to create custom filters, such as Watercolor Sketch, Oil Painting, Vintage Retro, and more, to create unique designs. When customers upload their photos, the system will automatically apply the selected filter to their images.



Click here for user experience demonstration: AI Filter Feature Demonstration


Connect API Key


Customall supports Gemini and OpenAI integrations for the AI Filter feature. Before using AI Filter, make sure you have connected an API key for either OpenAI or Gemini.


  • Go to Settings → Services.



  • Click the Config API Key button for the OpenAI/Gemini service.



  • Enter your API key.


You can find instructions on how to obtain your API key by clicking on the link titled How to get OpenAI/Gemini API Key.



After getting the API key, copy and paste it here:



Only the team leader account can access the Services section. After the team leader configures the API key, all team members can use the AI Filter feature.


Enable AI Filter in Artwork


Step 1: Add Image Layer


  • Go to Artwork Editor → Add an Image Layer → Enable the Allow Personalized feature.



Step 2: Set Layer Information


  • In the Layer Settings, fill in details such as label, help text, and placeholder.
  • Under Using value of, select AI Filter.



  • Set the minimum required width for the customer's uploaded image in the Min Width field.
  • Choose the Output Quality for images processed with AI Filter.

1K (1024px) is the fastest option and is ideal for apparel and previews. 2K (~2048px) and 4K (~4096px) produce sharper print files, which are better suited for canvas, posters, and large wall art.


2K and 4K resolutions require a configured Replicate API key in Service Settings. Please contact your team's admin if these options are unavailable.



For vintage, retro, or soft/blurry AI Filter styles, upscaling to 2K/4K will make the image sharper. As a result, the vintage or blurry effect may become less noticeable than expected. We recommend choosing the output quality based on the style and product type.


Step 3: Select AI Filter


  • Click Select AI Filter.



  • A pop-up will appear. You can choose an available filter or create a new filter.



In the available filter list, you can:
  • Search for a filter by name.
  • Filter the list by model.



Create a New AI Filter

If you want to create your own filter, follow these steps:


  1. Create New Filter


Click the Create Filter button.



  1. Configure Your AI Filter


Fill in the following information:



  • Choose Filter Model*:* Select a model that fits your needs
  • Enter Filter Name*:* Add a name for your filter
  • Upload Reference Image (Optional)**: Turn on this option to upload a style reference image



  • Add Custom Prompt*:* Describe the style or effect you want in detail. The more specific your prompt is, the better the result will be.


Note: If your prompt contains words or subjects that violate the terms of use of the selected AI model, the app will return the original uploaded image instead. You can view their policies here.


  • Upload Thumbnail (Optional)**: Upload a thumbnail image for your filter
  • Advanced settings: When using the Transparent Sketch Background for the Sketch Outline Filter, you can choose one of three options: Soft keeps lighter strokes, Strong makes strokes bolder, and Balanced is the default.



After completing all fields, click Next: Test Filter.



  1. Test Your Filter (Optional)


Upload a test image.
Click Run Test to preview how your filter works, or skip this step and save the filter directly.



The system will take a few moments to process.


After the image has been generated, you can click Re-test to create a new version. If you want to use the result as a thumbnail, check Use test result as thumbnail.



When you are satisfied, click Continue to Save.



  1. Save Your AI Filter


Review your filter settings → Click Save Filter to save it for future use.



You can change or remove the filter by selecting the corresponding action.



Customer Experience on Storefront


On the storefront, customers can upload their own photos and adjust the positioning by dragging and dropping, rotating, resizing, and setting the display exactly as they want.


Generate image history & Regenerate


Each AI Filter result is saved automatically, so customers can try several versions and pick their favorite before ordering. They no longer lose earlier results or need to upload their photo again.


Enable the feature


This feature is off by default. To turn it on:

  1. Go to Store Settings → General Settings.
  2. Tick Keep a history of customers’ AI generated images.
  3. Choose where the history appears:
    • All products: the history is available on every product in your store that has an AI Filter or AI Generate Image layer.
    • Specific products: the history is available only on the products you choose. Enter or paste their IDs in the Product IDs field. You can find a product’s ID in your store admin; it’s the number at the end of the product URL.
  5. Click Save


Your generated images


  • After the first generation, a "Your generated images (n/5)" section appears under the upload field. It keeps the 5 latest versions, newest first. When a 6th image is generated, the oldest one is removed.
  • Clicking a thumbnail applies that version to the preview. The selected version has a highlighted border.
  • If the AI Filter prompt uses text from other fields (for example a name), those fields are refilled with the values used for that version. The customer can add to cart right away.
  • The version the customer selects is the one used for the cart, the order, and the print file.
  • Each thumbnail has an ✕ button to remove it. If the customer removes the selected version, the version next to it is applied automatically.
  • Regenerate: The Regenerate button creates a new version from the original photo of the selected version. The customer doesn't need to upload again, and earlier versions are kept.




Photos must be in JPG, PNG, or JPEG format and must not exceed 12 MB. This limit is set by third-party services.


If your OpenAI or Gemini account runs out of credits or quota, the system will display an error notification when customers upload their photos


OpenAI or Gemini may not send notifications when your account runs out of credits, so it's important to monitor your credit balance regularly.

Updated on: 11/11/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!