{"name":"Post Editor Render API","description":"Deterministic request body for creating social post or carousel images. LLMs should fill this JSON directly; no design generation endpoint is required.","deliveryNote":"URL delivery is temporary. Rendered files are cleaned up automatically and should be fetched immediately.","imageNote":"PNG rendering supports data:image URLs and remote HTTP(S) images. Remote images are fetched temporarily during rendering and are not stored as source data.","directPngEndpoint":"POST /api/render.png returns raw image/png for the requested slide. Use ?slide=2 for carousel slide 2.","limits":{"maxCarouselSlides":20,"maxTextBlocksPerSlide":30,"maxImageOverlaysPerSlide":30,"maxRemoteImageBytes":12582912,"remoteImageTimeoutMs":10000},"coordinateSystem":{"units":"preview pixels","note":"Coordinates match the editor preview space. The renderer scales them to the selected platform export size.","previewScale":0.375},"platforms":{"tiktok-carousel":{"name":"TikTok Carousel","width":1080,"height":1350,"ratio":"4:5"},"tiktok-story":{"name":"TikTok Story","width":1080,"height":1920,"ratio":"9:16"},"instagram-post":{"name":"Instagram Post","width":1080,"height":1350,"ratio":"4:5"},"instagram-square":{"name":"Instagram Square","width":1080,"height":1080,"ratio":"1:1"},"instagram-story":{"name":"Instagram Story","width":1080,"height":1920,"ratio":"9:16"},"linkedin-post":{"name":"LinkedIn Post","width":1200,"height":1200,"ratio":"1:1"},"linkedin-portrait":{"name":"LinkedIn Portrait","width":1080,"height":1350,"ratio":"4:5"}},"brands":{"thebar":{"textColors":["#FFFFFF","#F5F5F5","#D4AF37","#F0D060","#2ECC71","#E74C3C"],"highlightColors":["#D4AF37","#E74C3C","#2ECC71","#000000","#F0D060","transparent"]},"cookpaddy":{"textColors":["#FFFFFF","#000000","#0C513F","#FFC600","#FF6B35","#E74C3C"],"highlightColors":["#FFC600","#0C513F","#FF6B35","#E74C3C","#000000","transparent"]},"custom":{"textColors":["#FFFFFF","#000000","#FF0000","#00FF00","#0000FF","#FFFF00"],"highlightColors":["#FF0000","#00FF00","#0000FF","#FFFF00","#000000","transparent"]}},"enums":{"mode":["single","carousel"],"stepperStyle":["none","numeric","dots","dots-outline","bars","pills","line","minimal"],"textStyle":["bold","shadow","outline","highlight"],"textSize":["S","M","L","XL"],"outputFormat":["png","svg"],"delivery":["dataUrl","url","both"]},"requestBody":{"type":"object","required":["slides"],"additionalProperties":false,"properties":{"platform":{"type":"string","enum":["tiktok-carousel","tiktok-story","instagram-post","instagram-square","instagram-story","linkedin-post","linkedin-portrait"],"default":"tiktok-carousel"},"mode":{"type":"string","enum":["single","carousel"],"default":"single"},"format":{"type":"string","enum":["png","svg"],"default":"png"},"delivery":{"type":"string","enum":["dataUrl","url","both"],"default":"dataUrl","description":"Use url for temporary hosted image URLs, dataUrl for inline base64, or both for both forms. Temporary URLs should be fetched immediately."},"brand":{"type":"string","enum":["thebar","cookpaddy","custom"],"default":"thebar"},"stepperStyle":{"type":"string","enum":["none","numeric","dots","dots-outline","bars","pills","line","minimal"],"default":"numeric"},"slides":{"type":"array","minItems":1,"maxItems":20,"items":{"type":"object","additionalProperties":false,"properties":{"backgroundColor":{"type":"string","pattern":"^#[0-9A-Fa-f]{6}$","default":"#000000"},"image":{"type":"string","nullable":true,"description":"HTTP(S) image URL or data:image URL used as cover background."},"textBlocks":{"type":"array","maxItems":30,"items":{"type":"object","additionalProperties":false,"properties":{"text":{"type":"string"},"richText":{"type":"string","description":"Optional simple HTML text. Supports b/strong, i/em, u, s/strike/del, mark, br, and span style color/background-color/text-transform."},"emoji":{"type":"string"},"size":{"type":"string","enum":["S","M","L","XL"],"default":"L"},"fontSize":{"type":"number","minimum":8,"maximum":240,"default":36},"style":{"type":"string","enum":["bold","shadow","outline","highlight"],"default":"bold"},"textColor":{"type":"string","pattern":"^#[0-9A-Fa-f]{6}$","default":"#FFFFFF"},"highlightColor":{"type":"string","default":"#D4AF37"},"x":{"type":"number","default":50},"y":{"type":"number","default":300},"width":{"type":"number","nullable":true},"height":{"type":"number","nullable":true},"maxWidth":{"type":"number","nullable":true},"rotation":{"type":"number","minimum":-180,"maximum":180,"default":0}}},"default":[]},"imageOverlays":{"type":"array","maxItems":30,"items":{"type":"object","required":["src"],"additionalProperties":false,"properties":{"src":{"type":"string","description":"HTTP(S) image URL or data:image URL."},"name":{"type":"string"},"x":{"type":"number","default":50},"y":{"type":"number","default":50},"width":{"type":"number","default":180},"height":{"type":"number","default":180},"rotation":{"type":"number","minimum":-180,"maximum":180,"default":0},"borderRadius":{"type":"number","minimum":0,"default":0},"cropX":{"type":"number","minimum":0,"maximum":100,"default":50},"cropY":{"type":"number","minimum":0,"maximum":100,"default":50},"color":{"type":"string","pattern":"^#[0-9A-Fa-f]{6}$","nullable":true,"description":"Optional color mask using the image alpha/luminance."},"opacity":{"type":"number","minimum":0,"maximum":1,"default":1}}},"default":[]},"counterPosition":{"type":"object","nullable":true,"properties":{"x":{"type":"number"},"y":{"type":"number"}}}}}}}},"examples":{"singlePost":{"platform":"instagram-square","mode":"single","format":"png","delivery":"url","brand":"thebar","slides":[{"backgroundColor":"#111111","textBlocks":[{"text":"Curl render proof","fontSize":44,"style":"highlight","textColor":"#000000","highlightColor":"#D4AF37","x":44,"y":190,"maxWidth":320}]}]},"carousel":{"platform":"instagram-post","mode":"carousel","format":"png","delivery":"url","brand":"thebar","stepperStyle":"numeric","slides":[{"backgroundColor":"#000000","textBlocks":[{"text":"5 content ideas for tonight","fontSize":48,"style":"bold","textColor":"#FFFFFF","x":42,"y":120,"maxWidth":330}]},{"backgroundColor":"#D4AF37","textBlocks":[{"text":"Turn one insight into a carousel","fontSize":42,"style":"outline","textColor":"#FFFFFF","x":42,"y":160,"maxWidth":330}]}]},"remoteImage":{"platform":"instagram-square","mode":"single","format":"png","delivery":"url","slides":[{"image":"https://placehold.co/128x128/png","textBlocks":[{"text":"Remote image background","fontSize":40,"style":"bold","textColor":"#FFFFFF","x":44,"y":120,"maxWidth":320}]}]}},"example":{"platform":"instagram-post","mode":"carousel","format":"png","delivery":"url","brand":"thebar","stepperStyle":"numeric","slides":[{"backgroundColor":"#000000","textBlocks":[{"text":"5 content ideas for tonight","fontSize":48,"style":"bold","textColor":"#FFFFFF","x":42,"y":120,"maxWidth":330}]},{"backgroundColor":"#D4AF37","textBlocks":[{"text":"Turn one insight into a carousel","fontSize":42,"style":"outline","textColor":"#FFFFFF","x":42,"y":160,"maxWidth":330}]}]}}