生成图片 - 旧版
根据用户传入的 JSON 配置生成图片,返回图片的访问链接
迁移提示
此接口(旧版蓝图 API)不再新增功能。
我们强烈建议您迁移至全新的 生成图片 API,新版接口带来以下强大升级:
- 基于 JSX/HTML 渲染:直接使用前端熟悉的标签结构,告别复杂的“蓝图” JSON 协议。
- 现代样式支持:全面支持内联样式(
style)和 Tailwind CSS 类名快速排版。 - 自定义字体库:支持按需动态加载网络自定义字体,实现极致排版效果。
- 多格式导出:支持灵活导出高质量的 WebP、PNG 和 JPEG 图片格式。
根据传入的蓝图,同步生成图片,返回图片的访问链接。
在此接口中,调用者可以实时控制蓝图,具有最高的灵活性。
请求
- HTTP URL:
https://api.imgrender.net/open/v1/pics - HTTP Method: POST
- 版本: v1
请求参数
Header 参数
| 字段 | 数据类型 | 必填 | 描述 |
|---|---|---|---|
| X-API-Key | string | yes | 用于请求授权,请参考 请求认证方式 |
| Content-Type | string | yes | 固定值:"application/json; charset=utf-8" |
Body 参数
Body 必须且只能传入 蓝图 数据。
响应
当请求成功时,HTTP 状态码为 200,并且会以 JSON 格式返回数据:
{
"code": 0,
"message": "ok",
"data": {
"url": "https://davinci.imgrender.cn/6e31cfcd683a36d0522a8cc34e244379.jpg?sign=xxx"
}
}code:错误码,当错误码为0时,表示处理成功,其他值表示存在一定的问题。message:提示信息,与code相对应,更多提示信息可查看状态码与错误码。data:返回的数据。当code为0时返回,其中url为图片链接。图片链接的有效期为 5 分钟,请及时下载或展示图片。超时后,重新请求即可获取新的访问链接。
错误码
| 错误码 | HTTP 状态码 | 说明 | 排查建议 |
|---|---|---|---|
20105 | 403 | 图片生成失败 | 请根据提示信息处理 |
更多通用错误码见:状态码与错误码