图像

SVG转图片

0次调用
1 积分/次

需要将灵活的 SVG 矢量图形转换为常见的光栅图像格式吗?这个接口可以帮你轻松实现。

功能概述

上传一个 SVG 文件,并指定目标格式(如 PNG、JPEG 等),接口将返回转换后的图像。你还可以调整输出图像的尺寸和(对于JPEG)压缩质量,以满足不同场景的需求。

查询参数

format
string可选

输出图像的目标格式。支持的值:png, jpeg, jpg, gif, tiff, bmp

width
integer可选

输出图像的宽度(像素)。如果省略,将根据 height 保持宽高比,或者使用 SVG 的原始宽度。

height
integer可选

输出图像的高度(像素)。如果省略,将根据 width 保持宽高比,或者使用 SVG 的原始高度。

quality
integer可选

JPEG 图像的压缩质量(1-100)。仅当 formatjpegjpg 时有效。

请求体

要转换的 SVG 文件。

file
file可选

支持SVG文件

响应

200 / 请求成功

转换成功!响应体是转换后图像的二进制数据。

image/*
图片响应说明
Response · Image/*
这是什么

接口返回的是图片的二进制数据流,而非 JSON 对象。客户端在接收到响应后,需要将其作为图片文件进行解析和处理。

前端展示方案

在浏览器环境中,最标准的做法是将响应体读取为 Blob 对象,并通过 URL.createObjectURL 生成一个临时的本地访问地址,最后将其赋值给 <img> 标签。为了避免内存泄漏,建议在图片加载完成后释放该 URL。

TYPESCRIPT
Node.js 服务端保存方案

如果是在 Node.js 环境中调用该接口,可以将响应转换为 ArrayBuffer,再转为 Buffer 并写入本地文件系统。

TYPESCRIPT

400 / 错误的请求

请求无效。可能是未上传文件或指定了不支持的输出格式。

JSON

500 / 服务器内部错误

服务器内部错误。SVG 渲染或文件处理过程中发生错误。

JSON