MCP/Tools/Images/generate_image
generate_image

Generate an ad creative image

Medium cost

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

How it works

The workhorse image tool. Pass a prompt, optionally hand it a brandId - the tool weaves your brand colors, voice, aesthetic, and saved logo into the render. Supports every Claivra-supported aspect ratio plus ad-spec presets like 1.91:1 (auto-resized to the exact 1200×628 Google Display Network spec). Pass an array via aspectRatios and the tool produces one image per ratio in a single bounded-concurrency batch.

Inputs

Name
Type
Required
Description
prompt
string
required
Director-style brief describing the image to render.
model
'claivra-v1' | 'claivra-v2' | 'claivra-v3' | 'claivra-v4' | 'claivra-v5' | 'claivra-v6' | 'claivra-v7' | 'claivra-v8'
optional
Default claivra-v1. claivra-v1 (2-5 credits; 1K/2K/4K; free plan): Cheapest photorealism - drafts, volume and believable photo backgrounds. claivra-v2 (1-34 credits; 1K/2K/4K, quality tiers): Dense layouts - posters, UI mockups and designs carrying a lot of small text. claivra-v3 (3 credits; native size, no logo): Exact typography - when a headline has to hold a specific typeface or lettering. claivra-v4 (2 credits; native size, no logo): Quick, punchy photoreal images when speed matters more than control. claivra-v5 (4-7 credits; 1K/2K/4K): Following a layout brief precisely, with crisp text and the brand logo - the best all-round choice for client ads. claivra-v6 (1-34 credits; 1K/2K/4K, quality tiers, transparent cutouts): The most realistic photography - real textures, lighting and materials. claivra-v7 (1-34 credits; 1K/2K/4K, quality tiers, transparent cutouts): Reworking an existing image with the tightest control over what changes. claivra-v8 (1 credit; native size, no logo): Fashion, lifestyle and editorial photography with a styled look - the lowest cost per image.
resolution
'1K' | '2K' | '4K'
optional
Output resolution (default 1K). Honored by claivra-v1, claivra-v2, claivra-v5, claivra-v6 and claivra-v7 - higher = more credits. claivra-v3, claivra-v4 and claivra-v8 render at native size (ignored).
quality
'low' | 'medium' | 'high' | 'xhigh' | 'max'
optional
Render quality. v2: low | medium | high (default medium). v6/v7: low | medium | high | xhigh | max (default high). Credits scale with the tier's real cost against the model's default (v6 at 2K: medium 2, high 6, xhigh 10). Ignored by v1/v3/v4/v5.
background
'auto' | 'opaque' | 'transparent'
optional
v6/v7 only. transparent returns a real alpha channel - a PNG cutout at no extra cost - for product shots, logos and anything you composite yourself. Skips the 1.91:1 ad-spec resize and the logo stamp, which would flatten it. Default auto.
aspectRatio
string
optional
Single ratio (1:1 default). Use aspectRatios for batch.
aspectRatios
string[]
optional
Multi-ratio batch - renders one image per ratio in parallel.
brandId
string
optional
Brand kit ID - wires colors + logo + voice into the prompt automatically.
logo
{ data: base64, mimeType: string }
optional
Override the brand's saved logo for this generation only.
referenceImages
Array<{ data, mimeType }>
optional
Style references the model anchors to.
featureBrandIds
string[]
optional
Other brand ids whose REAL logos to pull into the image (e.g. a client logo in an agency post) - fetched server-side so the model reproduces the actual logo, not an invented one.
cta
string
optional
CTA button text to overlay on the image.
tone
string
optional
Tone descriptor woven into the prompt.

Returns

{ imageId, imageUrl, mimeType } - or an array of refs when aspectRatios has 2+ entries.

Examples

Square ad with brand kit applied

Agent generates a 1:1 hero ad for a client's automotive brand. Brand colors, fonts, and logo are baked in via brandId.

{
  "prompt": "Hero shot of a green Rivian R1S parked in a sleek modern showroom with dramatic accent lighting. Bold headline overlay: 'EVs that mean business.' CTA pill bottom-center.",
  "model": "claivra-v1",
  "aspectRatio": "1:1",
  "brandId": "aBmbZETe9gUZhwXHCE02",
  "cta": "Get Your Quote"
}

Square + Google Ad in one call

Generate the same concept at both 1:1 (Instagram feed) and 1.91:1 (Google Display Network) - resized server-side to the exact 1200×628 spec.

{
  "prompt": "Minimalist studio shot of a Tesla Model S with bold typography overlay 'Drive into the future.'",
  "aspectRatios": [
    "1:1",
    "1.91:1"
  ],
  "brandId": "ectL5JsJKz55ItiFzEkB"
}

Related tools

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.

generate_variations

Generate variations of a reference image

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.

upload_image

Upload an image into your Claivra account

Push a base64 image you already have on disk (cropped, resized, brand-overlayed) into your Claivra media library - usable in create_share, revise_share, edit_image.

All toolsGet API key