v1

latestOpenAPI 3.1.02026-08-06244570.4 KB
Agent

Revise a template with the authoring agent

Send natural-language feedback on an existing image template; the agent revises the draft while keeping layer names stable. Asynchronous — poll GET /v1/agent/jobs/{job_id}; the completed job always includes a fresh preview_url.

Authentication: API Key required (x-api-key header)

Credits

A revision costs 10 credits, deducted when the job is queued and fully refunded if the job fails.

post/v1/agent/templates/{template_id}/revise

Path parameters

template_idstring required

Template short ID (12 characters)

Template short ID (12 characters)

Request body

feedbackstring required

Natural-language feedback on the current template.

Example request

{
  "feedback": "Make the title bigger and move the category chip to the top-left."
}

Response

Job queued

job_idstring required
status'pending' required
credits_chargedinteger required
credits_remaininginteger required