Layerize Image
Changed onRebuild a flat image into editable layers on a new canvas (metered; async job).
Creates a canvas sized to the image with the image placed as a full-page node, then starts the same hidden headless layerize job the in-app "Layerize" action runs: an agent reconstructs the image's background, objects, and text as separate editable nodes and merges the finished group back over the placed image. The response returns immediately with a task_id and the created canvas — poll GET /v1/media/layerize/{task_id} (about every retry_after_ms) until the status is terminal. The job typically takes a few minutes; the canvas shows the flat image until the merge lands.
Billing: metered as a normal agent run (model tokens plus per-call provider usage inside the job) against team credits — there is no fixed per-layerize price. The kickoff runs a credit precheck and returns the typed 402 when the balance refuses.
Request
- Base URLhttps://api.moda.app/v1
- URLhttps://api.moda.app/v1/media/layerize
- AuthHTTP bearer
Headers
Calendar-dated API version pin. New integrations should pin 2026-05-01 to opt into the newest response shapes. For back-compat the server also accepts requests with no header and resolves them to the current default (today: 2026-04-12); that default advances on each sunset date. Any unsupported value returns 400 unsupported_version.
Request body
Response
Successful Response
Changes
- info
endpoint added
- info