ComusThumbz Documentation
HTML Markdown Print/PDF Plain Text
Admin Login

Documentation Menu


Admin Access

AI Video Review

 

What This Page Does

This page uses artificial intelligence to analyze a video and automatically suggest improvements to its title, description, categories, tags, performer names, and SEO information. Instead of writing all of this by hand, the AI reviews your video's images and details, then fills in suggested content that you can edit and approve. This saves time and helps your videos get discovered by visitors and search engines.

[Screenshot: ai-video-review-overview]

How to Get Here

  1. Go to Admin Panel > Database > Videos.
  2. Find the video you want to analyze.
  3. Click Edit to open the video details.
  4. Click the AI Review button in the toolbar.

Understanding the Page

When you start an AI review, the page goes through two stages: a progress screen while the AI works, and a review screen where you check and approve the results.

The Progress Screen

After you click AI Review, a progress screen appears while the AI analyzes your video. You will see:

  • A progress bar that fills up as the analysis moves through each step
  • A status message below the bar that tells you what the AI is currently doing (for example, "Fetching video metadata..." or "AI is analyzing video...")
  • A Cancel button if you want to stop and go back to the video list

The analysis typically takes 30 to 90 seconds. When it finishes, the page automatically moves to the review screen.

 

Tip: You do not need to click anything while the progress bar is running. Just wait for it to finish and the review page will load on its own.

 

[Screenshot: ai-video-review-progress]

The Review Screen

Once the AI finishes, you are taken to the review screen. This is where you see everything the AI suggested and decide what to keep, change, or remove.

The review screen has several sections:

Info Bar -- At the very top, a summary bar shows:

Item What It Means
Overall Confidence How confident the AI is in its suggestions, shown as a percentage. Green means high confidence, orange means moderate, and red means low.
Analysis Cost The small credit charge for this analysis.
AI Model Which AI was used for the analysis.

Video Details -- A quick-reference grid showing the video's duration, resolution, frame rate, file size, and other properties. This is for your reference only and cannot be edited here.

Preview Image -- If your video has a preview image available, it appears here. Click the image to view it full-size. Press Escape or click the X to close the enlarged view.

[Screenshot: ai-video-review-preview-image]

Common Tasks

How to Review AI Suggestions

The main area of the review screen is split into two columns:

  • Left column (Current Data) -- Shows what the video currently has. This side is read-only for reference.
  • Right column (AI Suggested Data) -- Shows what the AI recommends. These fields are fully editable.

Each suggestion has a small colored confidence badge next to it:

  • Green -- The AI is highly confident in this suggestion
  • Orange -- The AI is moderately confident; review this more carefully
  • Red -- The AI is less certain; double-check this suggestion

 

  1. Compare each row between the current data and the AI suggestion.
  2. Edit any suggested field you want to change by clicking into it and typing.
  3. Move through all the sections to review everything before saving.

How to Edit the Title

  1. Look at the Title field in the right column.
  2. Click into the field and type your changes.
  3. Watch the character counter below the field. Shorter titles (60-70 characters) work best for search engines.

 

Tip: A good title is descriptive and includes relevant keywords that people might search for.

 

How to Edit the Description and Short Description

  1. Find the Description field in the right column. This is a larger text box.
  2. Click into it and edit the text as needed. Aim for 150 to 300 words for the full description.
  3. Below it, the Short Description is a brief summary (50 to 100 words). Edit this the same way.

How to Manage Categories

The AI suggests categories based on the video content. You can adjust these:

  1. To remove a category, click the X on its green badge.
  2. To add a category, select one from the dropdown menu and click the + button.

 

Note: If the AI suggested a category that does not exist on your site, it appears in an orange warning box. You can add that category through the Category Management page if you want to use it.

 

How to Manage Tags

Tags help visitors find your content through search and browsing.

  1. To remove a tag, click the X on its green badge.
  2. To add a new tag, type it into the text field below the tag badges and press Enter.

How to Manage Performers (Models)

The AI may identify or suggest performer names for the video.

  1. Suggested performers appear as green badges. To remove one, click the X on its badge.
  2. To add a performer, type their name in the search field. Matching names from your database will appear as you type.
  3. If the performer is not in your database, a Create new option appears. Click it to add them.

 

Warning: AI identification of performers may not always be accurate, especially when the confidence level is low. Always double-check performer names before saving.

 

How to Edit SEO Information

Scroll down to the SEO Metadata section. This controls how your video appears in search engine results and when shared on social media.

Field What It Controls Recommended Length
Meta Title The title shown in search engine results Up to 60 characters
Meta Description The summary shown in search engine results Up to 160 characters
OG Title The title shown when shared on Facebook Keep it concise
OG Description The description shown when shared on Facebook Keep it concise
Twitter Title The title shown when shared on Twitter Keep it concise
Twitter Description The description shown when shared on Twitter Keep it concise
  1. Click into any field to edit it.
  2. For Meta Title and Meta Description, watch the character counter. It turns red if you exceed the recommended length.

 

Tip: Search engines may cut off your title after 60 characters and your description after 160 characters, so keep the most important words at the beginning.

 

[Screenshot: ai-video-review-seo-section]

How to Edit Social Media Posts

Below the SEO section, you will find ready-to-use posts for three platforms:

  • Facebook Post -- A longer-format description you can copy and paste to Facebook.
  • Twitter Post -- A short post limited to 280 characters, including hashtags.
  • Instagram Caption -- A caption with hashtags for Instagram.

Edit any of these to match your preferred tone and style before saving.

How to Review Visual Analysis Results

If the AI analyzed an image from your video, a Visual Analysis section appears at the bottom of the page. This section shows what the AI detected, including:

  • Detected Performers -- Names of people the AI identified, with confidence levels
  • Scene Description -- A written description of what appears in the video
  • Setting/Location -- Where the scene takes place
  • Quality Assessment -- The AI's rating of production and lighting quality
  • Visual Themes -- General themes detected in the content
  • Color Palette -- The dominant colors and visual mood
  • Detected Text -- Any visible watermarks, logos, or on-screen text

 

Note: The visual analysis section is read-only and is provided for your reference. It helps you understand what the AI detected but does not directly change your video's public information.

 

[Screenshot: ai-video-review-visual-analysis]

How to Save Your Changes

Once you have reviewed and edited all the suggestions:

  1. Click Approve & Save to save your changes and return to the video list.
  2. Or click Approve & Next to save your changes and immediately move to the next video for AI review.
  3. Click Cancel to discard all changes and go back without saving.

 

Warning: Clicking Cancel discards everything on the review page. If you have made edits you want to keep, use one of the Approve buttons instead.

 

 

Success: After you click an Approve button, your changes are saved and the updated information will appear on your public site.

 

Credits and Costs

Each AI analysis uses a small amount of credits from your ComusThumbz license.

  • You need at least $0.50 in credits to run an analysis.
  • If your balance is below $5.00, a yellow warning will appear on the review page with a link to purchase more credits.
  • The exact cost of each analysis appears in the info bar at the top of the review page.

 

Tip: Running AI review on multiple videos in a row using the Approve & Next button is the fastest way to optimize your entire video library.

 

Tips for New Users

 

Tip:
  • Start with your most popular or newest videos to get the biggest impact from AI suggestions.
  • Always review the AI suggestions before saving. The AI does a good job, but it is not perfect.
  • Pay attention to the confidence scores. High-confidence suggestions usually need little or no editing, while low-confidence suggestions should be reviewed more carefully.
  • Use the SEO fields to improve how your site appears in Google and other search engines.
  • The social media posts are a great starting point for promoting your content. Copy and paste them to your social accounts after saving.

 

Troubleshooting

The progress bar seems stuck

What you see: The progress bar stops moving or the status message does not change.

How to fix it:

  1. Wait at least 90 seconds. Some analyses take longer than others, especially for the first time.
  2. If nothing changes after 90 seconds, click Cancel and try again.
  3. If the problem continues, check that your internet connection is working and try once more.

 

"Insufficient credits" error

What you see: An error message saying your credit balance is too low.

How to fix it:

  1. Visit the ComusThumbz website to purchase additional credits. A link is provided in the error message.
  2. You need at least $0.50 in credits to run an AI review.

 

"Video not found" error

What you see: An error saying the video could not be found.

How to fix it:

  1. Go back to Admin Panel > Database > Videos and confirm the video is still in the list.
  2. Click Edit on the video and try AI Review again.

 

"No image available for visual analysis" message

What you see: A notice that the AI could not find an image to analyze visually.

How to fix it:

  1. This means your video has not finished processing yet, or no preview images were generated.
  2. Check that the video has finished processing by looking at its status in the video list.
  3. The AI will still analyze the video using its text information, so you can continue with the review. The visual analysis section simply will not appear.

 

The review page says "No AI video data"

What you see: The review page loads but says there is no data to review.

How to fix it:

  1. This happens if the page session timed out or if you opened the review page directly.
  2. Go back to the video's Edit page and click AI Review to start a fresh analysis.

 

AI suggestions do not seem accurate

What you see: The AI filled in information that does not match the video.

How to fix it:

  1. Check the overall confidence score at the top of the review page. Lower scores mean the AI was less certain.
  2. Edit any incorrect fields before saving. You have full control over every suggestion.
  3. If a video has very little existing information (no title, no description), the AI has less to work with and may be less accurate.

 

Page When to Use It
AI Batch Video Review When you want to run AI analysis on many videos at once instead of one at a time
Video Management To browse, search, and manage all videos on your site
Video Edit To manually edit a video's details without AI assistance
Category Management To add new categories that the AI suggested but that do not exist on your site yet
AI Learning Dashboard To see analytics and trends about your AI usage

Related Pages