imgrender

生成图片 - 旧版

根据用户传入的 JSON 配置生成图片,返回图片的访问链接

迁移提示

此接口(旧版蓝图 API)不再新增功能。

我们强烈建议您迁移至全新的 生成图片 API,新版接口带来以下强大升级:

  • 基于 JSX/HTML 渲染:直接使用前端熟悉的标签结构,告别复杂的“蓝图” JSON 协议。
  • 现代样式支持:全面支持内联样式(style)和 Tailwind CSS 类名快速排版。
  • 自定义字体库:支持按需动态加载网络自定义字体,实现极致排版效果。
  • 多格式导出:支持灵活导出高质量的 WebP、PNG 和 JPEG 图片格式。

根据传入的蓝图,同步生成图片,返回图片的访问链接

在此接口中,调用者可以实时控制蓝图,具有最高的灵活性。

点此 在线调试和查看交互式 API 文档

请求

  • HTTP URL: https://api.imgrender.net/open/v1/pics
  • HTTP Method: POST
  • 版本: v1

请求参数

Header 参数

字段数据类型必填描述
X-API-Keystringyes用于请求授权,请参考 请求认证方式
Content-Typestringyes固定值:"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 :返回的数据。当 code0 时返回,其中 url 为图片链接。图片链接的有效期为 5 分钟,请及时下载或展示图片。超时后,重新请求即可获取新的访问链接。

错误码

错误码HTTP 状态码说明排查建议
20105403图片生成失败请根据提示信息处理

更多通用错误码见:状态码与错误码

On this page