Regenerating Content

Regeneration is driven by the content-container change requests API (POST /projects/{projectId}/content-containers/{id}/change-requests). Two modes are supported:

Full regeneration

mode: "full" — discards the existing output and generates from scratch. Optional changes let you steer the new generation, for example switching media.type from video to slideshow, or picking a new overlay style.

Partial regeneration

mode: "partial" — edits one or more elements while keeping the rest:

• Caption only — pass changes.caption.
• Overlay text / style / position — pass the relevant overlay fields.
• Swap media — pass changes.media = true (regen new media) or a full MediaSchema object to change type / style / format.
• Slideshow slides — for slideshow containers, pass per-slide slideOps with keep / overlay / regen / replace.

You must include at least one change. Caption-only edits can't be combined with overlay or slide changes.

Clone from a platform post

The inspiration path uses the cloneFromPlatformPost workflow — pick a platform_post and Layers produces a brand-aligned variant. See Inspiration.

Cost

Every change request is priced in credits; partial edits are typically cheaper than a full regeneration because locked elements are reused.

Reference

• The full change-request schema — supported media types, overlay positions, slide operations — is described on the relevant API reference pages.