{"openapi":"3.1.0","info":{"title":"Placehold image and video API","version":"1.0.0","description":"Placehold is a placeholder image and video generator and API by Xerobi Labs. Put the size, colours, text and font in a URL and get back an image (SVG, PNG, JPEG, GIF, WebP or AVIF) or a video (MP4 or MOV, with an optional play button and progress bar or timecode). Sizes run from 10 to 4000 px for images and up to 1920×1080 for video. No account or API key.","contact":{"name":"Xerobi Labs","url":"https://placehold.xerobi.com"}},"servers":[{"url":"https://placehold.xerobi.com"}],"paths":{"/{size}":{"get":{"operationId":"getPlaceholderMedia","summary":"Generate a placeholder image or video","description":"Size may include a retina factor and format extension, e.g. 600x400, 400x300@2x.png, or a video extension, e.g. 1280x720.mp4. Optional path segments after the size are background and text colour: /600x400/0075de/ffffff.png.","parameters":[{"name":"size","in":"path","required":true,"schema":{"type":"string","examples":["600x400","300","400x300@2x.webp"]}},{"name":"text","in":"query","schema":{"type":"string"},"description":"Label text. Use \\n for new lines."},{"name":"font","in":"query","schema":{"type":"string","enum":["lato","lora","montserrat","noto-sans","open-sans","oswald","playfair-display","poppins","pt-sans","raleway","roboto","source-sans-pro","inter","dm-sans","space-grotesk","merriweather","roboto-mono"],"default":"lato"}},{"name":"weight","in":"query","schema":{"type":"integer","minimum":100,"maximum":900,"default":700}},{"name":"italic","in":"query","schema":{"type":"boolean"}},{"name":"size","in":"query","schema":{"type":"number"},"description":"Font size in px."},{"name":"align","in":"query","schema":{"type":"string","enum":["left","center","right"]}},{"name":"valign","in":"query","schema":{"type":"string","enum":["top","middle","bottom"]}},{"name":"transform","in":"query","schema":{"type":"string","enum":["uppercase","lowercase","capitalize"]}},{"name":"gradient","in":"query","schema":{"type":"string"},"description":"2-5 comma separated colours."},{"name":"angle","in":"query","schema":{"type":"number","default":135}},{"name":"pattern","in":"query","schema":{"type":"string","enum":["grid","dots","stripes","checker"]}},{"name":"radius","in":"query","schema":{"type":"number"}},{"name":"border","in":"query","schema":{"type":"number"}},{"name":"cross","in":"query","schema":{"type":"boolean"}},{"name":"quality","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":90}},{"name":"download","in":"query","schema":{"type":"boolean"}},{"name":"seconds","in":"query","schema":{"type":"number","minimum":1,"maximum":30,"default":5},"description":"Video only (.mp4/.mov)."},{"name":"fps","in":"query","schema":{"type":"integer","minimum":1,"maximum":60,"default":30},"description":"Video only."},{"name":"animation","in":"query","schema":{"type":"string","enum":["none","progress","timecode"],"default":"progress"},"description":"Video only."},{"name":"play","in":"query","schema":{"type":"boolean","default":true},"description":"Video only: centred play button."}],"responses":{"200":{"description":"The image","content":{"image/svg+xml":{"schema":{"type":"string","format":"binary"}},"image/png":{"schema":{"type":"string","format":"binary"}},"image/jpeg":{"schema":{"type":"string","format":"binary"}},"image/gif":{"schema":{"type":"string","format":"binary"}},"image/webp":{"schema":{"type":"string","format":"binary"}},"image/avif":{"schema":{"type":"string","format":"binary"}},"video/mp4":{"schema":{"type":"string","format":"binary"}},"video/quicktime":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid parameter"},"404":{"description":"Unrecognised path"},"413":{"description":"Output too large"}}}}}}