imgrender logo

图片生成

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

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

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

请求

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

错误码

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

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

请求参数

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 分钟,请及时下载或展示图片。超时后,重新请求即可获取新的访问链接。