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)Required

    e.g. {"type":"url","data":{"url":"…"}}

  • formatstring

    png | svg | pdf

  • logofile

    Optional center logo image

  • logo_scalenumber

    Optional logo scale (e.g. 0.22)

  • stylestring (JSON)

    Optional style object as JSON string

  • presetstring

    Optional 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
Response
{
  "format": "png",
  "mime": "image/png",
  "meta": { "content_type": "url", "reliability": { "score": 1 } },
  "auth": "guest",
  "data_base64": "iVBORw0KGgo…"
}