进阶示例

这一页放更接近真实使用的组合，适合直接复制到浏览器、终端或脚本里。

工作台

• 打开全屏示例工作台
• 查看 API 参考
• 查看 GitHub 仓库

纯色徽标

适合做最干净的发布图标。

curl "http://localhost:3000/icon?shape=circle&iconSize=160&bgColor=%23ffffff&borderColor=%23000000&borderWidth=2&enableShadow=0&exportSquare=0" \
  -o circle-clean.png

轮廓增强图钉

适合强调边缘和层次的预览图。

curl "http://localhost:3000/icon?shape=pin&iconSize=220&contourEnhance=1&contourOuterGlow=4&contourOuterWidth=8&contourMainWidth=4&contourInnerWidth=2&contourCornerSoftness=0.18&antiAliasScale=4&resizeStrategy=step-down" \
  -o pin-enhanced.png

相对路径图片

如果配置了 IMAGE_URL_PREFIX，可以直接传相对路径。

curl "http://localhost:3000/icon?shape=squircle&iconSize=200&image=/assets/demo/logo.png&enableShadow=1" \
  -o squircle-relative.png

正方形导出

适合需要规整画布的场景。

curl "http://localhost:3000/icon?shape=hexagon&iconSize=180&exportSquare=1&exportStrategy=center&marginX=16px&marginY=16px&enableShadow=1" \
  -o hexagon-square.png

Base64 图片输入

如果启用了 IMAGE_ENABLE_BASE64=1，可以直接传 data:image/*;base64,...。

curl "http://localhost:3000/icon?shape=square&iconSize=180&image=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO0fN9kAAAAASUVORK5CYII=" \
  -o square-base64.png

先看尺寸再渲染

先请求 /info，确认输出大小后再生成最终图片。

curl "http://localhost:3000/info?shape=squircle&iconSize=240&exportSquare=1&antiAliasScale=2"

上传本地文件

更适合在脚本里直接处理本地文件。

curl -X POST "http://localhost:3000/icon" \
  -F "shape=pin" \
  -F "iconSize=240" \
  -F "contourEnhance=1" \
  -F "enableShadow=1" \
  -F "shadowBlur=12" \
  -F "shadowOffsetY=6" \
  -F "image=@/path/to/your/icon.png" \
  -o pin-post.png