快速开始
imgrender 提供的高性能图片生成 api,可以将 JSX、HTML 转换为图片
介绍
imgrender 提供的高性能图片生成服务,可以使你的应用快速拥有图片生成能力,可用于自动生成海报、证书、商品封面图、博客封面、个性化广告图...
核心功能
代码即图片
只需传递一段 JSX/HTML 代码,即可渲染输出高质量图片(支持 WebP、PNG、JPEG 格式)。支持内联样式和 Tailwind CSS 类名,前端开发者零学习成本上手。
| 特性 | 说明 |
|---|---|
| 简单易用 | 传入 JSX/HTML 字符串,返回图片链接,无需搭建渲染服务 |
| 高性能 | 服务端渲染,毫秒级响应,无需担心浏览器环境开销 |
| 灵活定制 | 支持自定义尺寸、格式、质量,支持加载自定义网络字体 |
| 样式丰富 | 支持内联 style 和 Tailwind CSS 类名,轻松实现复杂布局 |
快速上手
只需 3 步,即可开始使用 imgrender:
1. 注册并创建应用
访问 imgrender 控制台,注册账号并登录。
登录后,进入 应用管理 页面,点击「创建应用」创建你的第一个应用。
2. 获取 API Key
在应用详情页,点击 新增密钥 即可生成 API Key。API Key 格式为:数字.随机字符串
安全提示
API Key 是调用服务的凭证,请妥善保管,不要提交到公开代码仓库或泄露给他人。
3. 调用 API
使用以下示例代码,即可生成你的第一张图片:
const response = await fetch('https://api.imgrender.net/open/v1/images/render', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'YOUR_API_KEY'
},
body: JSON.stringify({
content: '<div style={{ backgroundColor: "#3b82f6", padding: "40px", borderRadius: "12px" }}><span style={{ color: "white", fontSize: "32px", fontWeight: "bold" }}>Hello imgrender!</span></div>',
width: 800,
height: 400,
format: 'png'
})
});
const result = await response.json();
console.log('图片链接:', result.data.url);curl -X POST 'https://api.imgrender.net/open/v1/images/render' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{
"content": "<div style={{ backgroundColor: \"#3b82f6\", padding: \"40px\", borderRadius: \"12px\" }}><span style={{ color: \"white\", fontSize: \"32px\", fontWeight: \"bold\" }}>Hello imgrender!</span></div>",
"width": 800,
"height": 400,
"format": "png"
}'请求成功后,响应示例:
{
"code": 0,
"message": "ok",
"data": {
"url": "https://res.imgrender.net/xxx.jpg?sign=xxx"
}
}图片链接有效期
返回的图片链接有效期为 5 分钟,请及时下载或展示图片。超时后重新请求即可获取新的链接。