lianfan.huiwa.task.image.get (生图任务查询)

生图任务查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
task_top_query TaskTopQuery 必须 请求参数
  • task_query
  • TaskQuery
  • 必须
  • 请求业务参数
  • └ main_task_id
  • Number
  • 可选
  • 2510789
  • 主任务id
  • └ task_ids
  • Number []
  • 可选
  • 2510789
  • 任务id列表
  • └ only_main_task
  • Boolean
  • 可选
  • false
  • 只查询主任务
  • └ page_index
  • Number
  • 可选
  • 1
  • 指定查询第几页数据
  • └ page_size
  • Number
  • 可选
  • 10
  • 指定每页展示条数

响应参数

名称 类型 示例值 描述
pagination PaginationDTO 分页信息
  • └ total
  • Number
  • 31
  • 总量
  • └ page_size
  • Number
  • 20
  • 分页大小
  • └ page
  • Boolean
  • true
  • 是否分页
  • └ current_page
  • Number
  • 1
  • 页码
succeed Boolean true 是否成功
error_codes ErrorCodeDTO [] 错误信息
  • └ code
  • String
  • error
  • 错误码
  • └ message
  • String
  • message
  • 错误描述
model BaseImageTaskDTO [] 查询结果
  • └ task_id
  • Number
  • 22024
  • 任务id
  • └ cover_image_url
  • String
  • https://img.alicdn.com/imgextra/i1/O1CN01wCIOqv1UyR7rRf1yD_!!6000000002586-0-tps-760-650.jpg
  • 封面图
  • └ task_type
  • Number
  • 3
  • 任务类型,3:生图任务
  • └ task_biz_type
  • Number
  • 3
  • 任务业务类型,3:自由姿势
  • └ image_url
  • String
  • https://img.alicdn.com/imgextra/i1/O1CN01wCIOqv1UyR7rRf1yD_!!6000000002586-0-tps-760-650.jpg
  • 生成的图片
  • └ main_task_id
  • Number
  • 22023
  • 主任务id
  • └ pass_through
  • String
  • {}
  • 扩展字段
  • task_status
  • ImageTaskStatusDTO
  • 任务状态
  • └ status_value
  • Number
  • 2
  • 任务状态,2:生成中,4:生成成功,-1或者-2:生成失败
  • └ status_name
  • String
  • desc
  • 状态描述
  • └ remark
  • String
  • error
  • 失败原因
error ErrorCodeDTO 错误信息
  • └ code
  • String
  • error
  • 错误码
  • └ message
  • String
  • message
  • 错误描述

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
LianfanHuiwaTaskImageGetRequest req = new LianfanHuiwaTaskImageGetRequest();
LianfanHuiwaTaskImageGetRequest.TaskTopQuery obj1 = new LianfanHuiwaTaskImageGetRequest.TaskTopQuery();
LianfanHuiwaTaskImageGetRequest.TaskQuery obj2 = new LianfanHuiwaTaskImageGetRequest.TaskQuery();
obj2.setMainTaskId(2510789L);
obj2.setTaskIds(new Long[] { 2510789 };
);
obj2.setOnlyMainTask(false);
obj2.setPageIndex(1L);
obj2.setPageSize(10L);
obj1.setTaskQuery(obj2);
req.setTaskTopQuery(obj1);
LianfanHuiwaTaskImageGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<lianfan_huiwa_task_image_get_response>
    <pagination>
        <total>31</total>
        <page_size>20</page_size>
        <page>true</page>
        <current_page>1</current_page>
    </pagination>
    <succeed>true</succeed>
    <error_codes>
        <error_code_d_t_o>
            <code>error</code>
            <message>message</message>
        </error_code_d_t_o>
    </error_codes>
    <model>
        <base_image_task_d_t_o>
            <task_id>22024</task_id>
            <cover_image_url>https://img.alicdn.com/imgextra/i1/O1CN01wCIOqv1UyR7rRf1yD_!!6000000002586-0-tps-760-650.jpg</cover_image_url>
            <task_type>3</task_type>
            <task_biz_type>3</task_biz_type>
            <image_url>https://img.alicdn.com/imgextra/i1/O1CN01wCIOqv1UyR7rRf1yD_!!6000000002586-0-tps-760-650.jpg</image_url>
            <main_task_id>22023</main_task_id>
            <pass_through>{}</pass_through>
            <task_status>
                <status_value>2</status_value>
                <status_name>desc</status_name>
                <remark>error</remark>
            </task_status>
        </base_image_task_d_t_o>
    </model>
    <error>
        <code>error</code>
        <message>message</message>
    </error>
</lianfan_huiwa_task_image_get_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部