Skip to content
HALOWERK

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-render

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
titlestringYesMain text of the card.
subtitlestringNoOptional second text block.
site_namestringNoOptional brand or site name shown above the title.
templatestringNo
widthintegerNo
heightintegerNo
backgroundstringNoHex background colour.
background_tostringNoOptional second hex colour for a diagonal gradient.
text_colorstringNoHex text colour; default is black or white, whichever contrasts more.
accent_colorstringNoHex colour of the accent bar and site name.
max_title_sizeintegerNo
title_linesintegerNo
logo_base64stringNoThe 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_urlstringNoPublic 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.
formatstringNo
include_svgbooleanNo
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
    }
  }
}

Open original schema

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

All endpoints in this hub →