Bildwerk
og image render
Builds an SVG from a template ("standard": left-aligned with accent bar, "centered"), lays out text with Liberation Sans 2.1.5 (SIL OFL 1.1, metric-compatible with Arial) via fontkit including kerning: the title is fitted from max_title_size down to 32 px in 2 px steps into at most title_lines lines, then shortened with an ellipsis; the subtitle likewise. Glyphs are embedded as outlines (paths), so rendering does not depend on installed fonts, and the SVG is rasterised by librsvg (sharp).
POST https://bild.halowerk.com/v1/og-image-renderInputs
| Field | Type | Required | Description |
|---|---|---|---|
| title | string | Yes | Main text of the card. |
| subtitle | string | No | Optional second text block. |
| site_name | string | No | Optional brand or site name shown above the title. |
| template | string | No | |
| width | integer | No | |
| height | integer | No | |
| background | string | No | Hex background colour. |
| background_to | string | No | Optional second hex colour for a diagonal gradient. |
| text_color | string | No | Hex text colour; default is black or white, whichever contrasts more. |
| accent_color | string | No | Hex colour of the accent bar and site name. |
| max_title_size | integer | No | |
| title_lines | integer | No | |
| logo_base64 | string | No | The optional logo (PNG, JPEG, WebP), placed top right as base64 or data: URL, at most 10 MB decoded. Give either logo_base64 or logo_url. |
| logo_url | string | No | Public http(s) URL of the optional logo (PNG, JPEG, WebP), placed top right, fetched once (at most 10 MB). Private and local addresses are refused. |
| format | string | No | |
| include_svg | boolean | No |
Show full input schema
{
"type": "object",
"additionalProperties": false,
"required": [
"title"
],
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Main text of the card."
},
"subtitle": {
"type": "string",
"maxLength": 300,
"description": "Optional second text block."
},
"site_name": {
"type": "string",
"maxLength": 60,
"description": "Optional brand or site name shown above the title."
},
"template": {
"type": "string",
"enum": [
"standard",
"centered"
],
"default": "standard"
},
"width": {
"type": "integer",
"minimum": 200,
"maximum": 2400,
"default": 1200
},
"height": {
"type": "integer",
"minimum": 100,
"maximum": 2400,
"default": 630
},
"background": {
"type": "string",
"maxLength": 7,
"default": "#0243a9",
"description": "Hex background colour."
},
"background_to": {
"type": "string",
"maxLength": 7,
"description": "Optional second hex colour for a diagonal gradient."
},
"text_color": {
"type": "string",
"maxLength": 7,
"description": "Hex text colour; default is black or white, whichever contrasts more."
},
"accent_color": {
"type": "string",
"maxLength": 7,
"description": "Hex colour of the accent bar and site name."
},
"max_title_size": {
"type": "integer",
"minimum": 32,
"maximum": 160,
"default": 72
},
"title_lines": {
"type": "integer",
"minimum": 1,
"maximum": 5,
"default": 3
},
"logo_base64": {
"type": "string",
"minLength": 16,
"maxLength": 14000000,
"description": "The optional logo (PNG, JPEG, WebP), placed top right as base64 or data: URL, at most 10 MB decoded. Give either logo_base64 or logo_url."
},
"logo_url": {
"type": "string",
"format": "uri",
"maxLength": 2048,
"description": "Public http(s) URL of the optional logo (PNG, JPEG, WebP), placed top right, fetched once (at most 10 MB). Private and local addresses are refused."
},
"format": {
"type": "string",
"enum": [
"png",
"jpeg",
"webp"
],
"default": "png"
},
"include_svg": {
"type": "boolean",
"default": true
}
}
}Published input example
{
"title": "Ten paid image tools for AI agents",
"subtitle": "Placeholders, icon sets, SVG sanitising and more – pay per call with x402.",
"site_name": "HALOWERK bildwerk",
"background": "#0243a9"
}Result & documentation
Machine-readable documentation of this hub
Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.
More endpoints in this hub
- Bildwerk0.01 USDC
address plate blur
POSThttps://bild.halowerk.com/v1/address-plate-blurThe photo is read with Tesseract 5.3.4 (German + English, word boxes) at two scales and in sparse-text and block mode; small bright plaques with 1–5 dark characters (typical house-number signs) are additionally cut out and read one by one,
- Bildwerk0.003 USDC
ai disclosure metadata
POSThttps://bild.halowerk.com/v1/ai-disclosure-metadataChecks JPEG, PNG and WebP files for AI disclosure metadata: XMP DigitalSourceType and the IPTC Photo Metadata 2025.1 AI fields, C2PA/JUMBF stores (signatures are not validated), PNG text chunks and EXIF Software/UserComment, and returns a s
- Bildwerk0.008 USDC
animation to video
POSThttps://bild.halowerk.com/v1/animation-to-videoReads frame count, size, loop count and total duration from the file structure, then encodes with ffmpeg 6.1 in a child process under prlimit (no shell, empty environment, only the file protocol): GIF and APNG are demuxed natively, animated