场景图生成结果查询API参考

场景图生成结果查询

GET/POST /ai/image/background/generation/query

产品描述

根据场景图生成任务API获取到的任务ID，可调用该API查询背景图生成的生成结果。

请求参数

参数	类型	必填	参数描述
taskId	String	Yes	唯一的任务ID。根据任务ID查询对应的生成结果。

请求示例

Java

IopClient client = new IopClient(url, appkey, appSecret);
IopRequest request = new IopRequest();
request.setApiName("/ai/image/background/generation/query");
request.addApiParameter("taskId", "7xxxxxxx-2xxx-4xxx-8xxx-8xxxxxxxxxxx");
IopResponse response = client.execute(request);
System.out.println(response.getBody());
Thread.sleep(10);

响应参数

参数	类型	描述
resCode	Number	返回的结果码，其中200代表成功，详细错误码请参考错误码列表。
data	Object	返回的json结果数据。
taskMessage	String	返回任务信息。
taskId	String	唯一任务 ID。它用于后续的结果查询请求。
taskStatus	String	返回任务执行状态。
taskResult	Object[]	返回任务结果。
imageUrlList	Object[]	返回结果图片的url列表。
sceneTemplate	String	返回该生成任务使用的场景编号。
recordContent	String	返回该生成任务的历史数据信息。
taskStatus	String	返回该生成任务的执行状态。
taskMessage	String	返回该生成任务的信息。
requestId	String	唯一的请求ID。用于排查问题。
success	Boolean	返回的请求状态，代表请求是否成功。
resMessage	String	返回的请求信息。

响应示例

Java

{
  "data": {
    "taskResult": [
      {
        "imageUrlList": [
          "https://aibz-aigc-record.oss-ap-southeast-1.aliyuncs.com/pbg_result%2FMvRJHuDgDF%2FMvRJHuDgDF_3925947387.png?OSSAccessKeyId=LTAI5tAGoBnm5eYsnZ5E1zMr&Expires=4935975567&Signature=29Go0D26nksBs4K8JY0GJ4vHwUU%3D",
          "https://aibz-aigc-record.oss-ap-southeast-1.aliyuncs.com/pbg_result%2FMvRJHuDgDF%2FMvRJHuDgDF_3925947388.png?OSSAccessKeyId=LTAI5tAGoBnm5eYsnZ5E1zMr&Expires=4935975567&Signature=msIPWuZt1j8H0QVzVzZXbAk2VUM%3D"
        ],
        "taskStatus": "finished"
      }
    ],
    "taskId": "713f0cb3-f22f-490b-b3b7-3684f73bf2d6",
    "taskStatus": "finished"
  },
  "requestId": "210133e517193035913164122eaa87",
  "success": true,
  "resCode": 200,
  "resMessage": "success",
  "code": "0",
  "request_id": "2101725817193035913182132",
  "_trace_id_": "210133e517193035913164122eaa87"
}

错误码

错误码	错误信息	描述
500	system error	System error.服务器内部错误
501	rate limit exceed	当前接口已达到限流上限,请搜索Aidge产品咨询&服务群钉钉群号：105455001046，入群联系我们增加当前限制值。
700	invalid input	输入参数的格式不符合要求，resMessage 将返回详细的不符合要求的字段。
801	model failed	内部调用异常，请搜索Aidge产品咨询&服务群钉钉群号：105455001046，入群联系我们进行故障排除。
1000	content has sensitive data, please try other input	内容包含敏感数据，无法处理，请尝试其他输入。
1001	content control failed, please retry	风控服务运行异常，请搜索Aidge产品咨询&服务群钉钉群号：105455001046，入群联系我们。
1002	content risk filter failed, please contact us	风控服务运行异常，请搜索Aidge产品咨询&服务群钉钉群号：105455001046，入群联系我们。