VidIQ icon

VidIQ

YouTube & Instagram intelligence and AI content tools via vidIQ

Actions40

Studio & AI → Refine Thumbnail

AI-generated

Summary

Refines a source thumbnail using your instructions and optional concept, video, subject image, reference images, and mask. Source thumbnail, subject image, and mask can each be supplied by URL or by naming an n8n binary property.

Inputs

  • Source Thumbnail Input Type — Choose URL (default) or Binary Property for the source thumbnail.
  • Source Thumbnail (URL) — URL of the source thumbnail; shown when the source input type is URL.
  • Source Thumbnail Binary Property — Name of the incoming item's binary property holding the source thumbnail; shown when the source input type is Binary Property. Defaults to data.
  • Instructions (required) — Instructions describing how to refine the thumbnail.
  • Original Concept — The original concept the thumbnail was based on.
  • Video ID — ID of the video the thumbnail belongs to.
  • Subject Image Input Type — Choose URL (default) or Binary Property for the subject image.
  • Subject Image (URL) — URL of the subject image; shown when the subject input type is URL.
  • Subject Image Binary Property — Name of the incoming item's binary property holding the subject image; shown when the subject input type is Binary Property. Defaults to data.
  • Reference Images — JSON array of reference image URLs. Defaults to an empty array.
  • Mask Input Type — Choose URL (default) or Binary Property for the mask.
  • Mask (URL) — URL of the mask; shown when the mask input type is URL.
  • Mask Binary Property — Name of the incoming item's binary property holding the mask; shown when the mask input type is Binary Property. Defaults to data.
  • Timeout — Maximum time in milliseconds to wait for vidIQ; defaults to 60000 ms and must be at least 1000 ms.

Output shape

A single vidIQ tool result per input item.

The supplied source does not expose the operation implementation body, so the exact returned fields and any binary output handling cannot be determined.

Examples

Example 1: Refine a thumbnail using a URL and text instructions

Set the source thumbnail input type to URL, provide its URL, and enter Instructions. Optionally supply a subject image or mask by URL, reference image URLs, an original concept, and a video ID.

Example 2: Refine a thumbnail from incoming binary data

Set the relevant image input type to Binary Property and enter the name of the incoming binary property containing the image; the default property name is data.

Links

Discussion