# Smart Visual AI & Reference Library | Agility Writer Help

> Smart Visual AI creates images for your articles automatically. It reads your content, finds the right spots for images, and generates photos, charts, or…

URL: https://agilitywriter.ai/help/smart-visual-ai-reference-library/
Last-Modified: 2026-03-04
Author: Adam Yong

## **What is Smart Visual AI?**

Smart Visual AI creates images for your articles automatically. It reads your content, finds the right spots for images, and generates photos, charts, or graphs that match your writing.

![](/images/help/Smart-Visual-1.jpg)

### What Makes This Different?

**Other AI Writers:**

-   Generate articles without context-aware images
-   You create each image separately with custom prompts
-   Face cloning requires manual prompts for each image to keep the same person
-   No automatic data extraction for charts
-   You decide the placement for every image
-   No smooth workflow – lots of back-and-forth

**Smart Visual AI:**

-   AI automatically reads context and creates matching images
-   Face cloning works across all images – no custom prompts needed
-   AI extracts data from your content and creates charts automatically
-   AI places all images in the right spots
-   Done in 5-10 extra minutes by the system, a few clicks from you
-   Near API cost-price: 1 credit for 3 images, 2 credits for 7 images

**Bottom line:** We use the same powerful Nano Banana Pro model, but with a seamless workflow that eliminates the tedious prompt engineering and manual image generation.

## Examples

-   Face Cloning Using 2 Reference Images
    
    [https://aiseoarticle.com/visit-melbourne/ →](https://aiseoarticle.com/visit-melbourne/)
    
-   Heavy Data – Graphs & Charts
    
    [https://aiseoarticle.com/social-media-roi-report/ →](https://aiseoarticle.com/social-media-roi-report/)
    
-   Consistent Characters with Data Table
    
    [https://aiseoarticle.com/distilled-water-uses-safety-side-effects/ →](https://aiseoarticle.com/distilled-water-uses-safety-side-effects/)
    
-   Amazon Product Review – No need for manual reference images.
    
    [https://aiseoarticle.com/propane-gas-grill-review/ →](https://aiseoarticle.com/propane-gas-grill-review/)
    

### Key Features

-   **Reference Library**: Upload your photos (like headshots) to use across articles
-   **Face Cloning**: Keep the same person in all photos throughout your article
-   **Smart Visual Types**: AI creates photos, charts, graphs, or infographics based on your content
-   **Auto Placement**: AI finds the best spots in your article for images
-   **Enhanced Infographics**: Professional data visualizations created from your content

## Reference Library: Your Personal Image Collection

### What is the Reference Library?

A place to store up to 20 photos that Smart Visual AI can use when creating images. Perfect for keeping yourself, team members, or products consistent across all your articles.

**Examples:**

-   Your headshot for personal blog posts
-   Product photos for reviews
-   Brand ambassador photos
-   Team member photos

## Getting Started

![](/images/help/Smart-Visual-1-1.jpg)

**Step 1: Access the Library**

1.  Go to **Settings** > **Reference Library**
2.  You’ll see your upload area and image grid

**Step 2: Upload Images**

Requirements:

-   **Formats**: JPEG, PNG, or WEBP
-   **Max size**: 1MB per image
-   **Max count**: 20 images total
-   Images wider than 1024px are automatically resized

**Upload Steps:**

1.  Click **Choose File**
2.  Select your image
3.  Click **Upload Image**
4.  Wait for confirmation

**Tips for Best Results:**

-   Use high-quality, well-lit photos
-   Front-facing portraits work best for face cloning
-   Avoid sunglasses or anything covering the face
-   No heavy filters or editing
-   Clear focus on the main subject

**Step 3: Add Details**

After uploading, click **Edit** on any image to add:

-   **Reference Name**: A short name you’ll see when selecting images (e.g., “John Headshot”)
-   **Description**: Up to 150 characters explaining the image (e.g., “Professional headshot, business casual, smiling”)

## Using Reference Images in Your Articles

**Where Smart Visual AI Works**

**Available in these modes:**

-   Advanced Mode
-   Website Page
-   Rewrite Article
-   Optimize Article
-   Product Round-up Review: Auto-pickup reference images from Amazon. Just set your avatar.

**Selecting Reference Images**

![](/images/help/Smart-Visual-2.jpg)

**When creating an article:**

1.  Scroll to **Image Settings** section
2.  Find **Reference Images (Max 3)**. This option only available when Smart Visual image model is selected.
3.  Click **Browse Images**
4.  Select up to 3 images from your library
5.  Click **Apply** or close the dialog

**Important:** You can select up to 3 reference images per article. This limit ensures the best results from the AI.

![](/images/help/Smart-Visual-3.jpg)

**Face Cloning Explained**

When you add reference images, Smart Visual AI analyzes the faces and recreates the same person in different scenarios throughout your article.

**Example:**

-   You upload your headshot
-   Your article is about “10 Morning Routines”
-   AI generates images showing YOU exercising, drinking coffee, working at a desk, etc.
-   Same person, different contexts

**Best For:**

-   Personal blogs and thought leadership
-   Brand ambassador content
-   Tutorial and how-to guides
-   Product demonstrations with people
-   Story-based content

**The “Same Person” Option**

In Image Settings, you’ll see a **Same Person** dropdown with two options:

**No** – Generate diverse persons across all images. Ensure you don’t attach human reference images.

-   Each photo may have different people
-   Good for general articles

**Yes** – Generate the same or similar person across all images

-   Works with OR without reference images
-   With reference images: Uses your uploaded faces
-   Without reference images: AI creates a consistent fictional person

**Important Note:** Don’t combine “Same Person: Yes” with “No. Photo with People: Exclude people” – they conflict.

## How Smart Visual AI Creates Images

![](/images/help/Smart-Visual-4.jpg)

**Understanding Context-Aware Generation**Smart Visual AI reads your content and decides what type of image works best for each section.

**The AI Looks At:**

-   Section headings (H2, H3)
-   Text around the placement spot
-   Data, numbers, and statistics
-   Keywords and topics
-   Your Image Style setting (Photo, Illustration, etc.)

**Types of Visuals Created**

**Photos & Realistic Images:**

-   When content describes scenarios, people, or places
-   Examples: “morning routine,” “team meeting,” “workspace setup”

**Charts & Graphs:**

-   When content has data, percentages, or comparisons
-   Examples: Bar charts, line graphs, pie charts
-   AI extracts your data and visualizes it accurately

**Infographics:**

-   When inforgraphic option is set.
-   Professional design with your data
-   Examples: Process flows, timelines, statistical summaries

**Note:** You can’t manually choose which sections get which type. The AI decides based on content. This automation is what saves you hours of work.

**Smart Visual Options**

| Feature | Smart Visual – 3 | Smart Visual – 7 |
| --- | --- | --- |
| Images Generated | Exactly 3 images | Exactly 7 images |
| Credits Used | 1 credit | 2 credits |
| Best For | Shorter articles (1000-2000 words) | Longer articles (2000+ words) |

Note:

## Getting the Best Results

**Reference Library Tips**

-   **Use descriptive names**: “Sarah Smiling Headshot” not just “Photo1”
-   **Keep images updated**: Remove old or unused photos
-   **Stay within limits**: 1-3 reference images per article works best
-   **Quality matters**: High-resolution photos give better face cloning results

**Content Type Guidelines**

**Technical/Data-Heavy Content:**

-   Gets more charts and graphs
-   Works well with statistics and comparisons
-   Example: “10 Marketing Statistics” will get data visualizations

**Lifestyle/How-To Content:**

-   Gets more photos with people
-   Works well with reference images
-   Example: “Morning Routines” will get contextual photos

## Frequently Asked Questions

**Reference Library\*\*\*\*Q: What happens to my articles if I delete a reference image?**

A: Nothing. Already-published articles keep their images. Only new articles are affected.

**Q: Can I use stock photos as references?**

A: Yes, but we recommend using your own photos or AI-generated images for better, more unique results.

**Q: How do I choose the best reference image?**

A: Pick high-quality, front-facing photos with good lighting. Avoid sunglasses, hats, or anything covering the face. Business headshots work great.

**Smart Visual AI**

**Q: How many images will be generated?**

A: Exactly 3 images for Smart Visual – 3, or exactly 7 images for Smart Visual – 7. This is fixed because of the credit pricing structure.

**Q: Can I control where images are placed?**

A: No, placement is automatic. But you can move images to different spots after the article is generated.

**Q: Will the same person appear in all photos?**

A: Yes, if you either:

-   Add reference images (uses your uploaded faces), OR
-   Set “Same Person: Yes” (AI creates a consistent fictional person)

**Q: How does AI decide between photo vs. chart?**

A: The AI reads the content around each placement spot. Data and numbers trigger charts. Descriptive text triggers photos. Lists trigger infographics.

**Q: Can I regenerate specific images?**

A: Not yet. This feature may be added in the future.

**Technical**

**Q: Does this work in all languages?**

A: Yes, Smart Visual AI works with articles in any language.

**Q: What AI model is used?**

A: Nano Banana Pro – a powerful model known for face cloning and professional photo generation.

**Q: How long does generation take?**

A: Expect 5-10 minutes extra compared to regular article generation. The AI is analyzing content, extracting data, and creating custom images for your article.

**Q: Are the images copyright-free?**

A: Yes. You own full rights to all generated images and can use them commercially.

**Q: Is Smart Visual AI available to everyone?**

A: Yes, all users can access Smart Visual AI features.

**Q: What if something goes wrong?**

A: Smart Visual AI is in beta. While it works well most of the time, occasional issues may happen. Report problems to support so we can improve.

## Troubleshooting Common Issues

**Quality Issues\*\*\*\*To improve face cloning:**

-   Upload high-resolution reference photos (close to 1024px width)
-   Use photos with good, even lighting
-   Clear background works better than cluttered ones
-   Multiple angles help (front view, slight side view)

**To get better charts:**

-   Include specific numbers in your content
-   Format data clearly (percentages, comparisons)
-   Use lists or bullet points for data

**To improve photo relevance:**

-   Write more descriptive content around headings
-   Add specific details about scenarios or settings
-   Mention relevant keywords

### Pricing Transparency

-   **Smart Visual – 3**: 1 credit for 3 custom images
-   **Smart Visual – 7**: 2 credits for 7 custom images

This is nearly cost-price with minimal margin. We can only offer this rate because of the efficient batch processing when generating full articles.

## Still need help?

Browse the full help center or start writing on a $1 trial.

Help center

[/help/ →](/help/)

 

Try for $1

[https://app.agilitywriter.ai/register →](https://app.agilitywriter.ai/register)