Skip to main content

Compose creative in another format via AI

POST 
/v1/compose

Supplies a source creative (PDF, PNG, or JPEG) and target dimensions, then queues an asynchronous AI recomposition job. Returns immediately with a jobId and QUEUED status. Poll GET /v1/compose/{jobId}/status to check the job status and retrieve the generated files once processing is complete.

Two ways to supply the source creative - use whichever is easier:

  • multipart/form-data with a file field (direct upload, ~4.5MB max: the request body is base64-encoded before this endpoint ever sees it, and Lambda's synchronous invoke payload cap is 6MB, so anything raw-larger than ~4.5MB fails before it reaches us)
  • application/json with a fileUrl field (we fetch it - any public HTTP(S) URL, not just S3; use this for anything bigger than ~4.5MB)

Request​

Responses​

Job accepted and queued