How it works
Claivra downloads the image itself, so you only pass the link. Dropbox and Google Drive share links work when shared 'anyone with the link'. The file is kept exactly as-is and saved to your media library. If a site blocks downloads, the error says so and points to create_upload_link. PNG, JPEG or WebP, up to 20MB.
Inputs
Name
Type
Required
Description
imageUrl
string
required
Public link to the image.
label
string
optional
Short label used in the conceptKey.
brandId
string
optional
File it under a brand kit.
Returns
{ imageId, imageUrl, mimeType, generationId, conceptKey, savedToMedia }Examples
Pull a product shot from the client's Drive
The client shares a Drive link. The agent imports it and uses it as the base for compose_ad.
{
"imageUrl": "https://drive.google.com/file/d/<id>/view",
"label": "Hero product shot"
}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.
compose_adTurn your own photo into a finished ad
Put the brand logo, headline, sub-line and CTA button over a real photo - the photo itself is never changed.