Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Labelixa Com Graphics API
version: 0.4.0
description: 'Operations tagged Graphics across 2 of this provider''s published API definitions: labelixa-com-api-openapi.json, labelixa-com-openapi.json. Each path carries the servers of the definition it was published in.'
tags:
- name: Graphics
paths:
/v1/graphics:
post:
summary: Convert image to ZPL graphic
description: 'Converts an uploaded image (PNG, JPEG, BMP, GIF; up to 200 KB and 2000x2000 px) or a PDF (up to 5 MB; each page becomes one label) to a ZPL `^GF` graphic. `X-Label-MM` with `X-Dpmm` prints at an exact physical size; `X-Wrap: label` returns a ready-to-print job; `X-Output: tspl` or `cpcl` returns a TSPL or CPCL job instead. Pre-processing headers: `X-Resize-Width/Height`, `X-Crop`, `X-Img-Rotate`, `X-Contrast`, `X-Dither`, `X-Invert`, `X-Threshold`. Every response carries `X-Print-Size-MM`. Counts as one operation; 400 for unreadable or oversized input.'
operationId: image_to_graphic_v1_graphics_post
requestBody:
content:
multipart/form-data:
schema:
$ref: '#/components/schemas/Body_image_to_graphic_v1_graphics_post'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Graphics
/v1/graphics/preview.png:
post:
summary: Preview ZPL graphic
description: Converts a `^GF` command back to PNG so you can see what reaches the printer. The body is the raw `^GFA,...` command only (up to 1 MB). Rate limit only; 400 when no `^GF` command or no decodable data is found.
operationId: graphic_preview_v1_graphics_preview_png_post
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
tags:
- Graphics
components:
schemas:
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
Body_image_to_graphic_v1_graphics_post:
properties:
file:
type: string
contentMediaType: application/octet-stream
title: File
type: object
required:
- file
title: Body_image_to_graphic_v1_graphics_post
x-refined-from:
- labelixa-com-api-openapi.json
- labelixa-com-openapi.json