creative-apps

Preview Cpp Set

Free, fast, live preview of the CPP screenshot-set builder: renders the REAL pipeline at 25% scale (or scale if given) so the builder UI can show a live view as the user tweaks layout/headlines/theme.

Two response shapes, selected by body.slide:

  • slide omitted/null: the full-strip render — one composited strip of all 6 slides (for the filmstrip rail).
  • slide set (0-5): the focused-slide fast path — same render (the full 6-slide canvas is still composited; cross-slide device bleed means a slide can't render in isolation) but the response encodes and returns ONLY that one slide's image, and slides_meta carries just that slide's regions in image-local coordinates. This is the hot interactive path for a focused-slide edit loop, so it's rate-limited on its own, more generous window (creative_preview.PREVIEW_SLIDE_RATE_LIMIT_PER_MIN) rather than sharing the full-strip budget.

No credit check or deduction, no CreativeBatch/Job/CreativeAsset rows, and no vision calls (geometric placement only) — true for both response shapes. Serialized per workspace (one render in flight at a time) regardless of slide.

post/v1/apps/{listing_id}/cpp-sets/preview

Request

  • Base URL: https://api.theagentc.io (the document declares no server; this is the origin it was published from)
  • URL: https://api.theagentc.io/v1/apps/{listing_id}/cpp-sets/preview
  • Auth: HTTP bearer

Path parameters

listing_idstring uuid required

Request body

devicestring
layoutstring
theme_promptstring nullable
theme_image_keystring nullable
slideinteger nullable
scalenumber nullable

Response

Successful Response

stripstring required
slide_winteger required
slide_hinteger required
theme_image_keystring nullable
scene_statusstring nullable
slideinteger nullable

Changes

No recorded changes to this operation across all 1 revision of this API.