CropDen: image sizes and AI image tools

social-media-image-sizes

14 个平台的图片尺寸：55 种规格，包含安全区域、上传限制和最小尺寸；另含 6 种护照和签证照片规格。提供 JSON、npm 包、Agent 技能和 MCP 服务。数据采用 CC BY 4.0 许可。

网站 · JSON · 中文说明

大多数尺寸列表只列出宽 × 高。裁剪图片时，你还需要知道应用会在图片上覆盖什么内容：YouTube 频道横幅上的头像、快拍底部的说明栏，以及会裁掉 4:5 Instagram 帖子的 3:4 个人主页网格。此数据集以像素为单位标出了这些区域。

快速预览

每行展示一种尺寸。每个类别在数据中都包含更多尺寸。

平台	图片	尺寸（px）	比例	在 CropDen 上裁剪
Instagram	3:4 竖版帖子（另有 3 种）	1080 × 1440	3:4	裁剪
Instagram	快拍（另有 2 种）	1080 × 1920	9:16	裁剪
Instagram	头像（另有 1 种）	320 × 320	1:1	裁剪
YouTube	频道横幅（另有 1 种）	2560 × 1440	16:9	裁剪
YouTube	视频缩略图（4K）（另有 2 种）	3840 × 2160	16:9	裁剪
YouTube	短视频（9:16）（另有 1 种）	1080 × 1920	9:16	裁剪
Facebook	封面照片（另有 2 种）	851 × 315	2.70:1	裁剪
Facebook	动态帖子（4:5）（另有 3 种）	1080 × 1350	4:5	裁剪
Discord	个人主页横幅（另有 3 种）	600 × 240	5:2	裁剪
Discord	自定义表情（另有 2 种）	128 × 128	1:1	裁剪
LinkedIn	个人主页背景（另有 3 种）	1584 × 396	4:1	裁剪
X (Twitter)	页眉照片（另有 3 种）	1500 × 500	3:1	裁剪
Twitch	个人主页横幅（另有 3 种）	1200 × 480	5:2	裁剪
TikTok	视频 / 照片幻灯片（另有 2 种）	1080 × 1920	9:16	裁剪
Pinterest	标准图钉（2:3）（另有 2 种）	1000 × 1500	2:3	裁剪
Snapchat	快拍 / Spotlight	1080 × 1920	9:16	裁剪
Etsy	商品列表照片（4:3）（另有 2 种）	3000 × 2250	4:3	裁剪
Shopify	商品图片	2048 × 2048	1:1	裁剪
eBay	商品列表照片	1600 × 1600	1:1	裁剪
Amazon	商品主图	2000 × 2000	1:1	裁剪

护照照片（在 CropDen 上制作）：

证件	像素	打印尺寸
美国护照和签证	600 × 600	50.8 × 50.8 mm
英国护照	600 × 771	35 × 45 mm
欧盟 / 申根	600 × 771	35 × 45 mm
加拿大	600 × 840	50 × 70 mm
澳大利亚	600 × 771	35 × 45 mm
中国签证	600 × 873	33 × 48 mm

所有尺寸及其区域都列在 data/social-media-image-sizes.json 中。要在浏览器中将图片裁剪为其中任意尺寸，请使用最后一列中的链接。

使用方法

npm

npm install social-media-image-sizes

import { getSize, groups } from 'social-media-image-sizes';

const post = getSize('instagram-post/portrait-34');
// { width: 1080, height: 1440, ratio: '3:4', exact: true, ... }

const youtube = groups.filter((g) => g.platform === 'YouTube');

也支持 CommonJS：const { getSize } = require('social-media-image-sizes')。

通过 HTTP 获取 JSON

const res = await fetch('https://cropden.com/data/social-media-image-sizes.json');
const { groups, passportPhotos } = await res.json();

该端点允许跨域请求，缓存时间为一小时。

与 AI Agent 搭配使用

技能：按正确尺寸制作图片

skills/social-media-image-sizes 是一项 Agent 技能，适用于 Claude Code、Codex、Cursor 及其他可读取 SKILL.md 的 Agent。你可以询问“把这张照片做成 YouTube 横幅”或“Instagram 快拍的尺寸是多少？”。它会选择合适的尺寸，使用 sharp 在你的设备上裁剪图片，确保文件低于上传限制，并绘制一张用红色标出覆盖区域的预览图。

npx skills add geektao1024/social-media-image-sizes

或者将该文件夹复制到 ~/.claude/skills/（Claude Code）或你的 Agent 技能文件夹中。

MCP 服务：尺寸与 AI 图片工具

CropDen 在 https://cropden.com/mcp 运行远程 MCP 服务（Streamable HTTP）。

工具	功能	费用
get_image_sizes	从此数据集中获取尺寸、安全区域和上传限制	免费，无需密钥
ai_extend_image	将图片扩展为更宽或更高的形状（扩图）	5 个积分
ai_upscale_image	放大 2 倍或 4 倍	8 或 12 个积分
ai_remove_background	透明 PNG	1 个积分
get_ai_task, get_credit_balance	查看长时间运行的任务、查看余额	免费，需密钥

Claude Code：

claude mcp add --transport http cropden https://cropden.com/mcp \
  --header "Authorization: Bearer YOUR_CROPDEN_API_KEY"

其他客户端：将 https://cropden.com/mcp 添加为使用相同请求头的 Streamable HTTP 服务。在 cropden.com 的 Settings → API keys 中获取密钥。AI 工具使用与网站相同的积分，运行失败时会退还积分。不提供密钥时，只能使用 get_image_sizes。

条目包含哪些内容

字段	含义
id	<group>/<size>，例如 youtube-banner/banner
width、height	导出的像素尺寸
ratio	宽高比，例如 3:4
exact	false 表示只需符合宽高比
recommended	一个分组中有多个尺寸时，我们推荐选用的尺寸
minWidth、minHeight	平台接受或要求的最小上传尺寸
maxBytes	上传大小上限，单位为字节（1 MB = 1,000,000）
zones	以像素为单位的区域：safe-area（内容需放在此区域内）、ui-overlay（会被应用覆盖）、crop-preview（其他视图中显示的内容）
zones[].measured	在实际运行的应用中测量；平台未公布此数据
zones[].x、y 等	从图片左上角起算的像素位置。区域可以超出边缘，例如叠在横幅底部的头像
note	一行提示，提供英文和中文版本

每个分组还包含 formats、facts（视频时长等信息）、verified，以及用于在 CropDen 上裁剪的 url。证件照还会提供以毫米为单位的打印尺寸，以及以照片高度为基准的头部和眼线范围。

如何核对这些数据

• 优先采用平台的帮助页面。如果平台没有公布相关信息（例如 Instagram 头像尺寸），我们会参考当前各指南一致采用的尺寸。
• measured: true 的区域是在应用中测量得出的。应用可能会调整按钮位置，因此请将这些数据作为参考。
• verified 表示上次核对该分组的月份。每个分组的来源链接将在 0.2.0 版本中添加。
• 如果发现尺寸已过时，请附上来源链接并提交 issue。

如果你只想查看平台官方公布的数据，请使用 The Social Specification，其中会将其他所有内容标记为未记录。本数据集专为裁剪而制作，因此会用实用尺寸和安全区域填补这些空缺。

网站介绍

CropDen 可用于裁剪。选择尺寸，在自己的图片上查看安全区域，并按精确像素尺寸导出，且不超过上传大小上限。裁剪和调整尺寸工具均在浏览器中运行。网站还提供批量调整尺寸和 AI 工具：扩展、放大和移除背景。

许可证

• 数据（data/，以及 index.js 和 index.cjs 中的相同数据）：CC BY 4.0。请按以下方式注明来源：Image size data by CropDen (https://cropden.com), CC BY 4.0。在网站上使用时，提供链接即可。
• 代码：MIT。

致谢

SammaPix（MIT）是我们确定需要涵盖哪些平台和证件照类型时的初始参考，我们也用其数据文件交叉核对了尺寸。

如果这为你省去了查找时间，请点个星，帮助其他人发现这个项目。

由 Geektao（@geektao0319，发布中文内容）公开开发。