How it works
For real cars, storefronts, faces and products that must stay exactly as shot. compose_ad lays the logo, headline, sub-line and CTA over your photo using the brand kit's colours and fonts. No AI model touches the photo, so it costs no image credits.
Inputs
Name
Type
Required
Description
baseImageId
string
optional
Your image (from create_upload_link, import_image_from_url or a render). Or pass baseImageUrl.
brandId
string
optional
Brand kit for logo, colours and fonts.
headline
string
optional
Main line of text.
subline
string
optional
Smaller second line.
cta
string
optional
Button text, e.g. 'Book a test drive'.
aspectRatio
string
optional
Output ratio, e.g. '4:5' or '9:16'.
Returns
{ imageId, imageUrl, width, height, creditsUsed: 0, logoComposited }Examples
Black Friday ad from a forecourt photo
The agent uploads the dealer's photo and composes a 4:5 ad with the offer and a CTA.
{
"baseImageId": "<imageId>",
"brandId": "<brandId>",
"headline": "Black Friday: 0% finance",
"cta": "Book a test drive",
"aspectRatio": "4:5"
}Related tools
create_upload_linkUpload a photo, logo or finished ad
Get a one-time link to send a real image file into Claivra - by curl, or a drop page the person opens.
generate_imageGenerate 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.