/bff/post/generate-thumbnail

Generates a new thumbnail image for the given post using OpenAI gpt-image-1. Inputs to the model: (a) one active reference image from the organisation library, (b) the post title and a short body excerpt in the org primary locale, (c) the organisation name, (d) the optional mood prompt. The generated image is stored in blob storage, linked to the post gallery, and becomes the main image if the post does not have one yet. Token spend is logged against the organisation monthly counter. Synchronous, ~10-30s. Returns 409 when no active reference image exists.

PostpostBffPostGenerate-thumbnail

Parameters

JSON body

Request body

application/json

idstringRequired

Post external ID.

Examplea1b2c3d4-e5f6-7890

Response schema

1 status code documented

200Success

This response returns no JSON body.

Response example

application/json

{
  "success": true
}

Request example

POST /bff/post/generate-thumbnail

post

curl -X POST "https://api.bizkithub.com/bff/post/generate-thumbnail" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "id": "a1b2c3d4-e5f6-7890"
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key