Zur Dokumentation springen
API

Eine Vorlage aus einem Briefing gestalten

Ein Designer baut aus Ihrem Text eine neue Blockvorlage.

POST/templates/design

Führt den echten Aufruf in Ihrem Workspace aus.

POST /templates/design

Ein Designer baut aus Ihrem Text eine neue Blockvorlage.

Beispiel

Erfordert templates:write. brief enthält alles, was das Design sagen und wie es aussehen soll. starter baut auf einem Startdesign auf, imageFileIds platziert bis zu zehn Bilder, und publish schaltet es sofort live. Antwortet mit 201, der Vorlage und design.

curl
curl -X POST "$OE/templates/design" -H "$AUTH" -H "Content-Type: application/json" \  -d '{ "name": "Spring launch", "brief": "A launch email for our spring collection: a hero image, three product cards and a button to the shop. Green and cream, friendly tone." }'
Antwort
{  "object": "template",  "id": "tpl_8f3a1c2e9b7d4a60",  "name": "Spring launch",  "slug": "spring-launch",  "status": "draft",  "publishedVersion": null,  "latestVersion": 1,  "design": {    "subject": "Spring is here",    "notes": [],    "imageProblems": []  }}

Es verbraucht eine KI-Aktion und kann bis zu einer Minute dauern. Ein Design, das sich nicht gültig machen lässt, ist ein 422 invalid_template, und ein Workspace ohne KI-Aktionen ein 429 ai_quota_exceeded.

Ein Bild, das ein auf einige Adressen beschränkter Schlüssel nicht erreicht, wird weggelassen und in design.imageProblems genannt.

Referenz