Batch Image Watermark

batch-image-watermark

Use Batch Image Watermark through the Zavilo SDK. Check input limits, parameters, output and supported modes below.

H · HeadlessI · InteractiveE · Embedded

ID da Toolbatch-image-watermark

Versão1

ExecuçãoCLIENT

ModosHeadless, Interactive, Embedded

Ações rápidas

Arquivos de entrada 1–30Arquivos de saída 1–30

Tratamento de resultados → Receitas → Exemplos de integração → Playground →

Entrada

Formatos de entrada e quantidade de arquivos aceitos por esta Tool.

Tipo de entrada	file
N.º de arquivos	1 – 30
MIME aceitos	image/jpeg, image/png, image/webp

Parâmetros

Passe estes valores por request.options.

Parâmetro	Tipo	Obrigatório	Padrão	Valores / Faixa	Descrição
`type`	enum	Opcional	`text`	text \| image	Watermark type. For image type, pass input.data.watermarkFile as a File.
`text`	string	Opcional	`© Your Brand`	—	Text watermark content.
`color`	string	Opcional	`#ffffff`	—	Text watermark color.
`opacity`	number	Opcional	`55`	5 – 100	Watermark opacity percentage.
`size`	number	Opcional	`24`	5 – 60	Watermark width as percentage of source width.
`rotation`	number	Opcional	`-30`	-180 – 180	Watermark rotation in degrees.
`margin`	number	Opcional	`4`	0 – 15	Edge margin percentage.
`position`	enum	Opcional	`bottom-right`	top-left \| top-center \| top-right \| middle-left \| center \| middle-right \| bottom-left \| bottom-center \| bottom-right	Watermark position.
`format`	enum	Opcional	`jpg`	jpg \| png	Output format.
`quality`	number	Opcional	`0.92`	0.6 – 1	JPG quality.

Saída

Formato do resultado retornado após o processamento.

Tipo	files
N.º de arquivos	1 – 30
MIME de saída	image/jpeg, image/png
Metadata	inputBytes, outputBytes, outputCount
Arquivo ZIP	Suportado · threshold 2

Uso básico

Escolha um modo suportado e copie o código inicial gerado.

Headless

const result = await client.run("batch-image-watermark", {
  files: selectedFiles,
  options: { type: "text", text: "© Your Brand", color: "#ffffff", opacity: 55 }
});
console.log(result.files, result.data, result.metadata);

Interactive

await client.open({
  tool: "batch-image-watermark",
  input: { files: selectedFiles },
  options: { type: "text", text: "© Your Brand", color: "#ffffff", opacity: 55 },
  onComplete(result) { console.log(result.files, result.data, result.metadata); }
});

Embedded

await client.mount({ tool: "batch-image-watermark", target: "#zavilo-tool", mode: "embedded" });

This page is generated from the SDK Tool Definition used by the runtime.