ai
POST /v1/ai/site-builds/{siteBuildId}/images
Draw the draft's images. Charges the content-images meter.
Authenticatie
Stuur een API-sleutel mee als bearer token. De sleutel moet over de permissie sites.create beschikken; een sleutel zonder deze permissie wordt geweigerd met een 403 in plaats van een 404.
Dit eindpunt vereist geen organisatie-id. Uw sleutel identificeert al de organisatie waartoe deze behoort, en het antwoord is hierop afgestemd.
Probeer het
Vervang alles tussen punthaakjes door uw eigen waarden en de sleutelplaatsvervanger door een sleutel uit uw dashboard.
curl -X POST https://api.zinndigital.com/v1/ai/site-builds/{siteBuildId}/images \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ "agreed_total_usd_micros": <integer> }'Ingelogd? De API-console in je dashboard vult je echte organisatie-id en je eigen sleutel in, en voert het verzoek uit tegen de live API zodat je de daadwerkelijke respons kunt zien. Open dit eindpunt in de API-console
Details
Generates every image the markup asks for and stores it against the draft, so a publish carries the pictures as well as the markup. **Send back the total you were quoted.** If the price has moved since — the catalogue changed, a model was withdrawn, another tab generated some of the same images — this is refused with `price_moved` and nothing is charged. A confirm that charged a different number from the one on the screen is the one thing a money confirm must never do. Images already generated are skipped and not re-charged, so pressing the button twice costs nothing the second time. Two meters bill for a draft with images: the build's own generation, and this. Both are visible on the organization's AI usage screen. Requires `sites.create`.
Parameters
| Naam | Type | Verplicht | Wat dit is |
|---|---|---|---|
siteBuildId (path) | Uuid | Ja | — |
Aanvraaglichaam
| Naam | Type | Verplicht | Wat dit is |
|---|---|---|---|
agreed_total_usd_micros | integer | Ja | The `total_usd_micros` you were quoted. Refused with `price_moved` if it no longer matches, and nothing is charged. |
provider | string | Nee | — |
model | string | Nee | — |
Reactie
| Naam | Type | Verplicht | Wat dit is |
|---|---|---|---|
images | SiteBuildImage[] | Ja | — |
build | SiteBuild | Ja | One "describe a site and we build it" run. `files` is present on the **detail** and create responses and absent from the **list**, deliberately: a generated tree can be a hundre… |
Fouten die dit eindpunt kan retourneren
401 · 403 · 404 · 422 · 429