Skip to content

v1.3.0

Choose a tag to compare

@antoox-yk antoox-yk released this 24 Sep 13:06
· 5 commits to main since this release
f201c73

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 button element accepts icon_url, icon_encoded and icon_color. icon_url is a public HTTP(s) URL of an image to place beside the label; icon_encoded is its base64 / data-URI twin, for an icon
    held in memory (icon_url wins if both are sent). icon_color recolours 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 button element accepts text_shadow_color, text_shadow_blur, text_shadow_offset_x and text_shadow_offset_y. A button has two shadows: the existing shadow_* properties are the shadow of the
    button box, and these four are the shadow of its label.

  • An image element accepts the five auto-focus properties at the top level: auto_focus_model, focus_objects, focus_framing, focus_target and focus_zoom, the flat form of auto_focus_properties.*.
    The nested form wins when both are sent. The face model is deprecated; use people with focus_framing.

  • An image element accepts expand and expand_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 a str
    either way.