Branding

Logo generation and branded template creation. Inject brand colours and style rules via the palette and logo_url fields. Both endpoints return a job_id with a matching GET …/status/{job_id} route, see Jobs.

Generate a logo

POST /branding/logo/image/v1, generate a logo from prompt. Pass an existing logo_url to incorporate your real mark.

curl https://api.imagepipeline.io/branding/logo/image/v1 \
  -H "X-API-Key: $IMAGEPIPELINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "minimal geometric mark for a developer tools company",
    "palette": ["#5b5bd6", "#0a0a0f"],
    "width": 1024,
    "height": 1024
  }'

Field	Type	Default	Notes
prompt	string	,	Required. Text description of the branded image.
logo_url	string	,	Public URL of your logo (PNG/WebP with transparency).
palette	string[]	,	Brand colours as hex codes, e.g. ["#FF5733", "#3498DB"].
width / height	integer	1024	Output dimensions (max 1024).
seed	integer	-1	-1 randomizes; set a value for reproducibility.
output_format	string	webp	webp, jpeg, or png.
callback_url	string	,	Receive a webhook on completion.
server_id	string	,	Enterprise: pin to a dedicated pod.

Generate a branded template

POST /branding/template/image/v1, generate a branded layout/template from prompt, honouring your palette. You can include hex codes directly in the prompt.

{ "prompt": "social announcement card with headline space", "palette": ["#5b5bd6", "#a5a5f5"] }

Field	Type	Default	Notes
prompt	string	,	Required. Describe the branded asset to generate.
palette	string[]	,	Brand colours as hex codes.
width / height	integer	1024	Output dimensions (max 1024).
seed	integer	-1	-1 randomizes; set a value for reproducibility.
output_format	string	webp	webp, jpeg, or png.
callback_url	string	,	Receive a webhook on completion.
server_id	string	,	Enterprise: pin to a dedicated pod.