Generate image
Start asynchronous AI image generation into the Media Library
202 with the image_id — the Media Library asset id — as soon as the job is queued. Poll Get image or subscribe to the image.generation.completed / image.generation.failed webhook events.
Pass asset_id to regenerate an existing generated image in place (same image_id, new render).
Scope required: images:write
Request body
"16:9", "1:1", "4:5", etc. Defaults to landscape.X-Idempotency-Key header. Replays with the same key return the same image_id without a second render.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
