根据传入的蓝图,同步生成图片,返回图片的访问链接。
在此接口中,调用者可以实时控制蓝图,具有最高的灵活性。
请求
错误码
错误码 | HTTP 状态码 | 说明 | 排查建议 |
---|---|---|---|
20105 | 403 | 图片生成失败 | 请根据提示信息处理 |
更多通用错误码见:状态码与错误码
请求参数
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 分钟,请及时下载或展示图片。超时后,重新请求即可获取新的访问链接。