只需一次 API 调用,即可使用 macOSicons.com 的全部内容。
30,000+ 个 macOS App 图标 触手可及。
从 Raycast 扩展、App 目录到图标自定义工具,看看大家实际用这个 API 做了什么。
用户在你的 Raycast 扩展或自定义启动器中输入时,实时获取匹配的图标。
非常适合公司 wiki 或内部工具门户。为每个 App 获取图标,让每个条目都清晰、统一。
在运营精选 Mac App 列表?为每个条目动态获取图标,无需自己四处寻找并托管截图。
让用户直接在你的 App 中浏览并应用自定义 macOS App 图标。
用 AI 生成图标,让任意图像符合 App 图标规范,并直接在你自己的工具中输出可用于 Xcode 的 .icns、Icon Composer 和资源目录文件,无需 Mac。
让任意图像符合 App 图标规范。只需一次调用,即可将图稿裁切到真实边缘,重新适配到 macOS 平滑圆角网格中,并套用 App 图标蒙版,让不规范的图标也完全合规。支持 PNG 或 WebP、任意尺寸,背景可选。
POST /editor/mask描述一个图标,即可获得一批 AI 生成的方案,每个都会自动符合规范:可以是平滑圆角的 App 图标,也可以是真实的 macOS 文件夹。
POST /editor/generate发送任意图像(PNG、Windows .ico,甚至压缩后的 Icon Composer .icon),即可获得包含完整标准尺寸集、可直接发布的 macOS .icns,还可以先套用平滑圆角加投影的标准样式。反过来也行:从现有 .icns 中提取所有 PNG。
POST /editor/convert · /editor/extract将图稿转换为 Icon Composer .icon 包(可直接拖入 Xcode 26 或更高版本),或用于资源目录的完整 AppIcon.appiconset:支持 macOS、iOS 或两者,iOS 版本会按 App Store 要求拼合。
POST /editor/icon · /editor/iconset一次请求,一个 zip:.icns、Windows .ico、Xcode .appiconset、Icon Composer 包,以及完整的网站图标包(含 manifest 和 HTML 代码片段)。这正是你的 CI 每次发布时要发起的调用。每种格式也可单独获取。
POST /editor/pack · /favicon将你的图标渲染到程序坞、iPhone 主屏幕或桌面样机中,用于 App Store 截图和发布推文:所有场景、浅色和深色模式,一次调用全部搞定。可以放在渐变、你自己的墙纸或由图标自身颜色生成的模糊背景上。另外还有颜色分析:主色、调色板和可直接使用的填充。
POST /editor/preview · /palette只需一条 curl 命令,即可获取数千个图标。
curl -X POST 'https://api.macosicons.com/api/v1/search' \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{"query": "Safari"}'
# Response
{
"hits": [
{
"appName": "Safari",
"lowResPngUrl": "https://...",
"icnsUrl": "https://...",
"iOSUrl": "https://...",
"category": "Browser",
"credit": "Elías",
"creditUrl": "https://...",
"downloads": 7523
}...
],
"query": "Safari",
"totalHits": 42,
"limit": 10,
"offset": 0,
"page": 1,
"totalPages": 4,
}登录即可立即访问你的面板和 API 密钥。
With an account you'll be able to submit new icons, view their approval status and more.