{"openapi":"3.1.0","info":{"title":"ImageNow Placeholder Image API","version":"1.0.0","description":"ImageNow is a free URL-based placeholder image API created by LiquidPixels. Create images by putting size, colors, format, DPR, and text directly in the URL for frontend development, CMS testing, QA states, ad mockups, Open Graph previews, and visual documentation."},"servers":[{"url":"https://my.imagenow.dev"}],"paths":{"/{size}/{background}/{foreground}.{format}":{"get":{"summary":"Generate a placeholder image","description":"Generate placeholder images from URL path parameters. Unsupported size routes return the normal 404 page; invalid colors fall back to defaults; unsupported extensions fall back to WebP.","parameters":[{"name":"size","in":"path","required":true,"description":"Size token: dimensions, square shorthand, ratio syntax, named preset, or DPR multiplier.","schema":{"type":"string"},"examples":{"dimensions":{"value":"1200x630"},"square":{"value":"512"},"ratioByWidth":{"value":"640x4:3"},"ratioByHeight":{"value":"16:9x1080"},"keyword":{"value":"hd720"},"retina":{"value":"300x250@2x"}}},{"name":"background","in":"path","required":true,"description":"Background hex color without #. Invalid values fall back to the default background.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{1,6}$"},"example":"0f172a"},{"name":"foreground","in":"path","required":true,"description":"Foreground hex color without #. Invalid values fall back to the default foreground.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{1,6}$"},"example":"f8fafc"},{"name":"format","in":"path","required":true,"description":"Output format extension. jpg is accepted as a JPEG alias; unsupported extensions fall back to WebP.","schema":{"type":"string","enum":["webp","png","jpeg","jpg","gif","avif"]},"example":"png"},{"name":"text","in":"query","required":false,"description":"Optional image label text. Text is normalized and truncated to 160 characters.","schema":{"type":"string","maxLength":160},"example":"Open Graph"},{"name":"txt","in":"query","required":false,"description":"Short alias for the text query parameter.","schema":{"type":"string","maxLength":160}}],"responses":{"200":{"description":"Generated placeholder image.","headers":{"Cache-Control":{"description":"public, max-age=31536000, immutable","schema":{"type":"string"}},"Access-Control-Allow-Origin":{"description":"Generated images are CORS-enabled with *.","schema":{"type":"string"}}},"content":{"image/webp":{},"image/png":{},"image/jpeg":{},"image/gif":{}}},"404":{"description":"Unsupported route or invalid size token."}}}}},"x-canonical-examples":[{"label":"Open Graph","url":"https://my.imagenow.dev/1200x630/0f172a/f8fafc.png?text=Open+Graph","description":"1200x630 social preview placeholder."},{"label":"Medium Rectangle","url":"https://my.imagenow.dev/300x250/111827/f8fafc.webp?text=Medium+Rectangle","description":"IAB 300x250 ad placeholder."},{"label":"Leaderboard","url":"https://my.imagenow.dev/728x90/1f2937/e5e7eb.gif?text=Leaderboard","description":"728x90 leaderboard ad placeholder."},{"label":"Avatar","url":"https://my.imagenow.dev/512/334155/e2e8f0.png?text=Avatar","description":"Square avatar or profile placeholder."},{"label":"Video","url":"https://my.imagenow.dev/16:9x1080/111827/22d3ee.jpeg?text=Video","description":"16:9 full HD video frame placeholder."},{"label":"Mobile","url":"https://my.imagenow.dev/9:19x844/111827/22d3ee.jpeg?text=Mobile","description":"Tall mobile mockup placeholder."},{"label":"HD Preview","url":"https://my.imagenow.dev/hd720/0f172a/f8fafc.png?text=HD+Preview","description":"Named 1280x720 preset placeholder."},{"label":"Full HD","url":"https://my.imagenow.dev/hd1080/0f172a/f8fafc.png?text=Full+HD","description":"Named 1920x1080 preset placeholder."},{"label":"Retina","url":"https://my.imagenow.dev/300x250@2x/111827/f8fafc.png?text=Retina","description":"2x physical density placeholder."},{"label":"Docs","url":"https://my.imagenow.dev/640x4:3/2563eb/ffffff.webp?text=Docs","description":"Width plus ratio documentation placeholder."}]}