Repository navigation
v1.3.0
Generated from API version v2026-09-24.
Minor, not patch: the models gained fields. No method changed, no signature moved, and nothing that worked against 1.2.0 needs touching. A generation body is a plain dict either way.
Added
-
A
buttonelement acceptsicon_url,icon_encodedandicon_color.icon_urlis a public HTTP(s) URL of an image to place beside the label;icon_encodedis its base64 / data-URI twin, for an icon
held in memory (icon_urlwins if both are sent).icon_colorrecolours the icon and only applies to an SVG. Sending an icon for a button designed without one adds it on the left, at the label's font size.
The icon's size, gap and side belong to the design and are not overridable per generation.client.generate_image( template_id, elements={"button_0": {"icon_url": "https://example.com/star.svg", "icon_color": "#FF0000"}}, )
-
A
buttonelement acceptstext_shadow_color,text_shadow_blur,text_shadow_offset_xandtext_shadow_offset_y. A button has two shadows: the existingshadow_*properties are the shadow of the
button box, and these four are the shadow of its label. -
An
imageelement accepts the five auto-focus properties at the top level:auto_focus_model,focus_objects,focus_framing,focus_targetandfocus_zoom, the flat form ofauto_focus_properties.*.
The nested form wins when both are sent. Thefacemodel is deprecated; usepeoplewithfocus_framing. -
An
imageelement acceptsexpandandexpand_properties: AI image expansion (outpainting), which extends the image past its borders to fill the target area instead of cropping or letterboxing it.
Changed
- Colour fields document a linear gradient of 2 to 8 stops instead of exactly two, and say where print accepts one: only a shape or button
background_color. The models are unchanged; a colour is astr
either way.