MCP/Tools/Images/generate_variations
generate_variations

Generate variations of a reference image

High cost

Re-skin / copy any ad (the 'AI Ad Copier'): upload a reference creative (+ optional logo), pick a Logo mode, add an offer / filters / resolution, and get N on-brand variant concepts that keep the structural framing.

How it works

Two-phase tool. First the agent passes a reference image (URL or base64) plus what to vary and the Copier options; the tool runs a vision pass, bakes the Copier directives (logo mode, offer, filters, optional WTF) into N concept prompts, and returns them immediately. The agent then renders each concept via generate_image (one call per variant; pass the returned resolution/model and - per logoMode - the logo). Use it to take a winning or competitor ad and produce 10 on-brand variants without losing the visual DNA.

Inputs

Name
Type
Required
Description
referenceImageUrl
string
optional
URL of the reference image. Preferred for Claivra-hosted images.
referenceImageBase64
string
optional
Base64 reference for images not reachable by URL.
count
integer (2–10)
optional
How many variant concepts to produce. Default 5.
varyOptions
string[]
optional
What to vary - vehicle, background, headline, cta, colors.
aspectRatios
string[]
optional
Aspect ratios to render each variant at. Default [1:1].
notes
string
optional
Extra direction for the vision/variant prompts.
profileId
string
optional
Niche profile applied to the variant prompts.
brandId
string
optional
Brand kit woven into the variants (also supplies the logo).
logoMode
string
optional
Re-skin branding mode: replace_branding (default), keep, remove, replace_product, make_unique. Decides which logo is composited at render.
logo
{ data, mimeType }
optional
Logo to composite (overrides the brand logo). Used by replace_branding / make_unique modes.
offer
string
optional
Featured offer hook, e.g. 'Free estimate', '20% off'.
resolution
'1K' | '2K' | '4K'
optional
Output resolution (default 1K). Honored by v1/v2/v5 at render; v3/v4 native. Echoed back in nextStep - pass to generate_image.
model
'claivra-v1' | 'claivra-v2' | 'claivra-v3' | 'claivra-v4' | 'claivra-v5'
optional
Which model to render the variants with - echoed back in nextStep. Default v1. For 2K/4K pick v1, v2, or v5.
awarenessStage
string
optional
Filter: unaware | problem_aware | solution_aware | product_aware | most_aware.
complianceMode
string
optional
Filter: standard | facebook_safe | legal_medical_safe | aggressive.
visualStyle
string
optional
Filter: auto | ugc | cinematic | product_demo | testimonial | before_after.
personGender
string
optional
Filter: any | female | male (for any person depicted).
personEthnicity
string
optional
Filter: any | caucasian | african_american | asian | hispanic_latino | middle_eastern | south_asian | mixed.
wtf
boolean
optional
Re-skin in an attention-hijacking 'WTF' style.
wtfRecipe
string
optional
Specific WTF recipe id (e.g. tabloid, claymation, kaiju).

Returns

{ concepts: [{ name, imagePrompt, cta, headline }], logoMode, resolution, requestedAspectRatios, nextStep } - follow nextStep: call generate_image per concept with the right resolution/model and mode-correct logo handling.

Examples

5 variants of a winning ad, square + Google Ad sizes

Plug Motors had a winning Tesla creative. Agent generates 5 variants for next week's test, each in both sizes.

{
  "referenceImageUrl": "https://cdn.claivra.com/file/claivra/.../tesla-winner.jpeg",
  "count": 5,
  "varyOptions": [
    "vehicle",
    "background",
    "headline"
  ],
  "aspectRatios": [
    "1:1",
    "1.91:1"
  ],
  "brandId": "aBmbZETe9gUZhwXHCE02",
  "notes": "Keep the green spotlight + reflective floor - those are the brand cues that work."
}

Copy a competitor ad with your branding (re-skin)

Found a competitor's high-performing creative. Re-skin it: replace their branding with the brand's, add the offer, render crisp 2K.

{
  "referenceImageUrl": "https://cdn.claivra.com/file/claivra/.../competitor-ad.jpeg",
  "count": 4,
  "varyOptions": [
    "headline",
    "background"
  ],
  "aspectRatios": [
    "1:1",
    "4:5"
  ],
  "brandId": "aBmbZETe9gUZhwXHCE02",
  "logoMode": "replace_branding",
  "offer": "$500 off this month",
  "resolution": "2K",
  "complianceMode": "facebook_safe"
}

Related tools

generate_image

Generate an ad creative image

Generate a single (or multi-aspect-ratio batch) ad creative from a director-style prompt, with optional brand kit + logo composite.

edit_image

Edit an existing image with an instruction

Apply a natural-language instruction to an existing image - swap headlines, change colors, remove text, replace backgrounds - without regenerating the whole composition.

All toolsGet API key