将图像调整为 通过API调整为任意尺寸
通过REST API将图像调整为精确的像素尺寸。将宽度、高度、适配模式(cover、contain、fill)和输出格式指定为multipart/form-data。非常适合缩略图、头像和响应式图像管道。
# Resize an image to specific dimensions
curl -X POST \
https://api.convertfilefast.com/v2/image/resize \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@photo.jpg" \
-F "width=800" \
-F "height=600" \
-F "fit=cover" \
-F "format=jpeg" \
--output resized.jpg
# HTTP 200 OK — Content-Type: image/jpeg
# fit options: cover, contain, fill, inside, outsideimport requests
response = requests.post(
"https://api.convertfilefast.com/v2/image/resize",
headers={"Authorization": "Bearer YOUR_API_KEY"},
files={"file": open("photo.jpg", "rb")},
data={
"width": "800",
"height": "600",
"fit": "cover",
"format": "jpeg"
}
)
with open("resized.jpg", "wb") as f:
f.write(response.content)const formData = new FormData();
formData.append("file", fs.createReadStream("photo.jpg"));
formData.append("width", "800");
formData.append("height", "600");
formData.append("fit", "cover");
formData.append("format", "jpeg");
const response = await fetch(
"https://api.convertfilefast.com/v2/image/resize",
{
method: "POST",
headers: { "Authorization": "Bearer YOUR_API_KEY" },
body: formData,
}
);
fs.writeFileSync("resized.jpg", Buffer.from(await response.arrayBuffer()));// n8n HTTP Request Node — Resize Image
{
"method": "POST",
"url": "https://api.convertfilefast.com/v2/image/resize",
"contentType": "multipart-form-data",
"bodyParameters": {
"parameters": [
{ "name": "file", "parameterType": "formBinaryData", "inputDataFieldName": "data" },
{ "name": "width", "value": "800" },
{ "name": "height", "value": "600" },
{ "name": "fit", "value": "cover" },
{ "name": "format", "value": "jpeg" }
]
},
"options": { "response": { "responseFormat": "file" } }
}优势
为什么使用我们的API?
完整可靠的解决方案,适用于任何技术栈的集成。
精确尺寸
以像素为单位指定精确的宽度和高度。无论源图像大小如何每次都能获得像素完美的输出。
灵活的适配模式
从cover、contain、fill、inside或outside适配模式中选择来控制图像如何填充目标尺寸。
格式转换
同时调整大小和转换格式。通过单个API调用以JPEG、PNG或WebP输出。
缩略图生成
大规模生成缩略图、头像和产品图像变体。在内容管道中自动化图像调整大小。
n8n工作流支持
在由文件上传、webhook或计划任务触发的n8n工作流中调整图像大小。
零存储
图像在内存中处理并立即删除。您的原件和调整后的输出永远不会存储。
如何使用
完成此转换的 4 个步骤
- 1
创建 API 密钥
在 convertfilefast.com/signup 注册,并从控制台复制以 cff_ 开头的 API 密钥。免费套餐包含每月 10 次转换。
- 2
将 图片 POST 到端点
以 multipart/form-data 方式 POST 到 https://api.convertfilefast.com/v2/image/resize,请求头为 X-API-Key: cff_your_key(也可使用 Authorization: Bearer),图片 通过 file 字段或公开 url 提供,并附上 width 和/或 height,以及可选的 fit(contain / cover / fill)。
- 3
接收 图片
响应体即为生成的 图片,并在 Content-Disposition 中带上文件名。可直接保存或传给流程的下一步 —— 我们不存储任何文件。
- 4
或从 AI 智能体调用
通过 https://mcp.convertfilefast.com/mcp 将 MCP 服务器添加到 Claude、Cursor 或任意兼容客户端,然后以单次工具调用执行 resize_image({ source_url: '...', width: 1200, fit: 'contain' }) —— 无需 HTTP 客户端,也无需处理文件。
也可以从 Claude、Cursor 或任意 MCP 客户端调用
Convert File Fast 提供原生的 Model Context Protocol 服务器。只需一次工具调用,即可把该转换交给 AI 智能体完成 —— 无需 HTTP 客户端,无需处理二进制,并为每个用户单独签发 API 密钥。
npx -y convertfilefast-mcpresize_image({ source_url: "https://example.com/photo.jpg", width: 1200, fit: "contain" })对比
Convert File Fast 与其他方案对比
| 产品 | 原生 MCP | 免费额度 | 价格 |
|---|---|---|---|
| Convert File Fast | 支持 | 10/month | $0.004/conv from $4 |
| Smallpdf | 不支持 | 2/day (unregistered) | $9/mo Pro |
| iLovePDF | 不支持 | Rate-limited | $7/mo Premium |
| Adobe Acrobat Online | 不支持 | Limited trials | $19.99/mo Acrobat Standard |
| CloudConvert | 不支持 | 25 conv-min | From $0.01/min |
竞品价格核对于 2026-07-16。
FAQ
常见问题
如何通过API调整图像大小?
向 https://api.convertfilefast.com/v2/image/resize 发送POST请求,将图像作为multipart/form-data上传。包含width和height字段(以像素为单位)以及可选的fit参数(cover、contain、fill、inside或outside)。API以二进制流形式返回调整大小后的图像。有关即用代码,请参阅上方的cURL和Python示例。
调整大小支持哪些图像格式?
API支持JPEG、PNG、WebP、AVIF、GIF、BMP、TIFF和HEIC作为输入格式。您还可以通过format参数指定输出格式(jpeg、png、webp),在单个请求中同时完成转换和调整大小。
我可以保留宽高比或将图像调整为特定尺寸吗?
可以。使用fit参数控制图像如何填充目标尺寸。cover裁剪图像以填满区域,contain在不裁剪的情况下适配图像,fill拉伸到精确尺寸,inside调整大小使两个维度都在框内,outside调整大小使至少一个维度超出框。所有模式都保持目标宽度和高度。
API如何处理图像质量和压缩?
传递quality参数(1到100的整数)来控制JPEG和WebP的输出压缩。默认值为85,在大多数使用场景下能很好地平衡文件大小和视觉质量。对于PNG,无论quality设置如何,都使用无损压缩。AVIF自动使用自适应压缩。
调整图像大小的文件大小限制是多少?
上限取决于你的套餐,并按 API 密钥生效 —— 当前接受的上限可在 https://api.convertfilefast.com/v1/info 查询,你自己套餐的上限显示在控制台中。
我可以在n8n、Zapier或批量管道中集成图像调整大小吗?
可以。图像调整大小端点是与任何HTTP客户端兼容的标准REST API。可在n8n HTTP请求节点、Zapier webhook、Make(Integromat)和Power Automate中使用。对于批量处理,循环遍历图像URL或文件路径并为每个调用端点。请参阅上方n8n示例标签获取可直接导入的节点配置。