POST `/v1/ai/images/posts/{postId}`

Generate a featured image and in-post images for a content post.

Аутентификација

Пошаљите API кључ као bearer токен. Кључ мора имати дозволу links.edit; кључ без ње се одбија уз 403, а не 404.

Где се уноси ID ваше организације

Ова крајња тачка узима org_id као поље у JSON телу.

Идентификатор ваше организације се налази на екрану са API кључевима на вашој контролној табли, поред самог кључа. То је исти идентификатор у сваком позиву који упутите.

Испробајте

Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.

curl -X POST https://api.zinndigital.com/v1/ai/images/posts/{postId} \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{  }'

Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли

Детаљи

Generates the images and writes the <img> placeholders into the post body, in one transaction. ⛔ Those are deliberately not two endpoints: one that generated images and left the body alone would produce rows in a table, nothing on a page, and a dashboard reporting success. Alt text is generated and stored in the source language and localised to the destination site's language when the post is published (§2.19) — one post goes to many sites, so the language is a property of the site, not of the draft. The response carries unmet: anything the chosen provider could not honour, in words for the customer. Nothing is silently dropped. Requires links.edit.

Параметри

Назив	Тип	Обавезно	Шта је ово
`postId (path)`	`Uuid`	Да	—

Тело захтева

Назив	Тип	Обавезно	Шта је ово
`featured`	`boolean`	Не	—
`inline_count`	`integer`	Не	⛔ Bounded at 4. A hundred near-identical stock-looking images across a network is a footprint, which is the one thing the Footprint-Free line exists to avoid.
`style`	`string`	Не	Woven into every prompt — "photographic, no text overlay, muted palette".
`provider`	`AiImageProvider \| string<>`	Не	Leave empty to let the platform choose.
`model`	`string`	Не	A specific `model_id` to pin, or empty to follow the provider's default.
`target_locale`	`string`	Не	The language the post will be published in, so alt text is localised to the site rather than to the dashboard's UI locale.
`org_id`	`Uuid`	Не	UUIDv7 identifier — sortable by creation time (docs/02 §8).

Одговор

Назив	Тип	Обавезно	Шта је ово
`data`	`GeneratedImage[]`	Да	—
`unmet`	`string[]`	Не	What the chosen provider could not honour, in words for the customer. ⛔ Present and empty rather than absent when everything was honoured, so a client can tell "nothing was…
`body_html`	`string`	Не	The post body with the generated images' placeholders written into it.

Грешке које ова крајња тачка може вратити

401 · 403 · 404 · 422 · 429