查询图片生成结果

更新时间:2026.01.26

通过本接口可查询指定任务的图片生成结果

接口说明

支持商户:【品牌商户】

请求方式:【GET】/brand/marketing/product-coupon/image-generation-tasks/{task_id}

请求域名:【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

     【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看

接口限频:20/秒(品牌ID维度)

请求参数

Header  HTTP头参数

 Authorization  必填 string

请参考签名认证生成认证信息


 Accept  必填 string

请设置为application/json


 Wechatpay-Serial  必填 string

【微信支付公钥ID】  请传入brand_id对应的微信支付公钥ID,接口将会校验两者的关联关系,参考微信支付公钥产品简介及使用说明获取微信支付公钥ID和相关的介绍。以下两种场景将使用到微信支付公钥: 1、接收到接口的返回内容,需要使用微信支付公钥进行验签; 2、调用含有敏感信息参数(如姓名、身份证号码)的接口时,需要使用微信支付公钥加密敏感信息后再传输参数,加密指引请参考微信支付公钥加密敏感信息指引


path  路径参数

 task_id  必填   string

【图片生成的任务ID】 品牌创建图片生成任务的请求流水号,品牌侧需保持唯一性,可使用 数字、大小写字母、下划线_、短横线- 组成,长度在6-40个字符之间


query  查询参数

 image_generation_type  必填   string

【图片生成类型】 与提交图片生成任务时所传的类型一致

可选取值

  • COMBINE_IMAGE:  适合全场类优惠头图,将品牌元素与商品券优惠等信息拼接生成头图

  • CUT_OUT:  适合单品类优惠头图,用于去除图片背景,保留商品主体

请求示例

curl
Java
Go

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/brand/marketing/product-coupon/image-generation-tasks/image_generation_task_1?image_generation_type=COMBINE_IMAGE \
3  -H "Authorization: WECHATPAY-BRAND-SHA256-RSA2048 brand_id=\"XXXX\",..." \
4  -H "Accept: application/json" \
5  -H "Wechatpay-Serial: PUB_KEY_ID_XXXX"  
6

应答参数
折叠全部参数

200 OK

 task_id  必填   string

【图片生成的任务ID】 品牌创建图片生成任务的请求流水号,品牌侧需保持唯一性,可使用 数字、大小写字母、下划线_、短横线- 组成,长度在6-40个字符之间


 image_generation_type  必填   string

【图片生成类型】 图片生成类型

可选取值

  • COMBINE_IMAGE:  适合全场类优惠头图,将品牌元素与商品券优惠等信息拼接生成头图

  • CUT_OUT:  适合单品类优惠头图,用于去除图片背景,保留商品主体


 task_state  必填   string

【任务状态】 任务状态

可选取值

  • PROCESSING:  任务执行中

  • FAIL:  任务失败

  • SUCCESS:  任务成功


 combine_image_result  选填   object

【拼图结果】 当 image_generation_type 为 COMBINE_IMAGE ,并且任务状态为 SUCCESS 时,该数据结构值有效

属性

 image_url  必填   string

【生成的图片URL】 当任务状态为 SUCCESS 时,返回该值,其他情况下不会返回


 cut_out_result  选填   object

【生成商品图结果】 当 image_generation_type 为 CUT_OUT ,并且任务状态为 SUCCESS 时,该数据结构值有效

属性

 image_url  必填   string

【生成的图片URL】 当任务状态为 SUCCESS 时,返回该值,其他情况下不会返回

应答示例

200 OK

1{
2  "task_id" : "image_generation_task_1",
3  "image_generation_type" : "COMBINE_IMAGE",
4  "task_state" : "PROCESSING",
5  "combine_image_result" : {
6    "image_url" : "https://wxpaylogo.qpic.cn/wxpaylogo/example.jpg"
7  },
8  "cut_out_result" : {
9    "image_url" : "https://wxpaylogo.qpic.cn/wxpaylogo/example.jpg"
10  }
11}
12

 

错误码

以下是本接口返回的错误码列表。详细错误码规则,请参考微信支付接口规则-错误码和错误提示

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

 

元宝AI
反馈
目录
置顶