Generate AI image
Starts asynchronous AI image generation into the site Media Library and returns 202 with the image_id (the Media Library asset id). Poll GET /images/ or subscribe to image.generation.completed / image.generation.failed. Pass asset_id to regenerate an existing generated image in place. Entitlement (IMAGE_GENERATION) is checked before anything is created — a denied plan returns 403 plan_upgrade_required with no side effects. Generated images are representative renders carrying an E-E-A-T disclaimer.
Authorizations
Your Hrizn API key (prefix hzk_)
Headers
Optional idempotency key. Repeats with the same key + body within 24h return the original response instead of creating a duplicate.
Body
What to render (subject, setting, mood) in plain language.
8000"A silver mid-size SUV parked outside a dealership at golden hour"
e.g. "16:9", "1:1", "4:5". Defaults to landscape.
16"16:9"
Attach the image to a Hrizn content item as an article image.
Existing generated image to regenerate in place.
Media Library asset keys used as visual references.
4Alternative to the X-Idempotency-Key header.
200Response
Image generation started
