API reference/15 of 22
Generate with logo
Multipart generate with a center logo file.
POST/api/v1/generate/upload
Same as generate, but accepts a multipart logo file. Call the VPS API directly (not through a serverless proxy) for large uploads.
Field content is a JSON string; logo is the optional file part (also accept style/preset/logo_scale). Limits: GET /api/v1/generate/options → limits.logo_bytes (default 8MB). Related: POST /api/v1/generate/preview.
Auth: Optional — guest, user JWT, or API key (Business for keys) · Scope: generate
Multipart fields
contentstring (JSON)Requirede.g. {"type":"url","data":{"url":"…"}}
formatstringpng | svg | pdf
logofileOptional center logo image
logo_scalenumberOptional logo scale (e.g. 0.22)
stylestring (JSON)Optional style object as JSON string
presetstringOptional preset id
curl -s -X POST "https://api.getmaxqr.com/api/v1/generate/upload?response=json" \
-F 'content={"type":"url","data":{"url":"https://example.com"}}' \
-F format=png \
-F logo=@./logo.png{
"format": "png",
"mime": "image/png",
"meta": { "content_type": "url", "reliability": { "score": 1 } },
"auth": "guest",
"data_base64": "iVBORw0KGgo…"
}