爆款图复刻

创建任务

请求体

图片地址须在生成期间保持可访问。

出图数量

A+参考图按提交顺序拼合后生成长图，实际宽高由生成模型、分辨率和生成结果决定，以查询结果中每张图片的 width、height 为准。手机 A+在同组高级 A+成功后生成。

比例与分辨率

指定模型、主副图比例和分辨率时，请按下表选择支持的值。A+图复刻的画幅按参考图处理结果和所选 A+规格确定。

模型和分辨率均可省略，未传、传 null 或空白时按以下规则处理：

1. 模型使用后台配置的爆款图复刻默认启用模型。
2. 分辨率优先使用该模型配置的默认分辨率，且默认值须在支持范围内；否则使用该模型支持的最高分辨率，例如支持 1K、2K、4K 时取 4K。
3. 生成和扣费均按最终确定的模型及分辨率执行。未配置可用默认模型或有效支持分辨率时，创建任务会报错。

请求示例

主副图复刻

两张参考图，每张输出 2 份，共 4 张结果图。模型及规格请按上方表格选择。

{
  "replicationMode": "SINGLE_IMAGE",
  "referenceImages": [
    { "imageUrl": "https://example.com/reference-1.jpg" },
    { "imageUrl": "https://example.com/reference-2.jpg" }
  ],
  "productImages": [{ "imageUrl": "https://example.com/product.jpg" }],
  "provider": "填写所选模型的API Code",
  "resolution": "2K",
  "outputNum": 2,
  "generationRatio": "1:1",
  "targetMarket": "美国",
  "language": "英语",
  "productInfo": "保温杯，耐用不锈钢材质，便携防漏"
}

A+图复刻

以下示例使用高级 A+＋手机 A+规格，输出 2 套，共 4 张长图；普通或高级 A+只需更换 aplusRatio。

{
  "replicationMode": "APLUS",
  "referenceImages": [
    { "imageUrl": "https://example.com/aplus-reference-1.jpg" },
    { "imageUrl": "https://example.com/aplus-reference-2.jpg" }
  ],
  "productImages": [{ "imageUrl": "https://example.com/product.jpg" }],
  "provider": "填写所选模型的API Code",
  "resolution": "2K",
  "outputNum": 2,
  "aplusRatio": "APLUS_PRO_AND_PHONE",
  "language": "英语",
  "productInfo": "保温杯，耐用不锈钢材质，便携防漏"
}

提交后返回什么

提交成功后返回任务编号 data.id，表示任务已创建，结果还需等待生成。请保存编号。查看返回示例。

查询生成结果

用任务编号 data.id 调用获取作图结果，每次查询至少间隔 10 秒。data.status=3 表示成功，从 data.resultList[].url 获取图片地址；data.status=4 表示失败。查看统一示例。

任务可能部分成功，请以每张图片的状态为准，仅下载 resultList[].status=1 的图片。主副图复刻按 resultList[].referenceIndex 区分参考图，高级与手机 A+按 resultList[].outputGroupId 配对。

每张结果图的字段如下，其他通用字段见获取作图结果。字段按模式、规格和任务进度返回，空值默认省略。

例如，2 张参考图、outputNum=2 全部成功时有 4 条结果：referenceIndex 分别为 1、1、2、2，每张参考图的 outputGroupId 分别为 "1"、"2"。同一主副图父任务内应使用 (referenceIndex, outputGroupId) 区分输出组，不能仅用 outputGroupId 区分不同参考图。

extendField 结构：

targetWidth、targetHeight 是目标规格，实际图片尺寸以结果图顶层的 width、height 为准。未指定 format 时，size 对应已保存的结果文件；指定 format=jpg 时返回在线转换地址，size 沿用图片元数据中的大小，不保证等于转换后响应的字节数。

A+切分预览

将成功生成的 A+长图切分为对应规格的图片。先通过获取作图结果取得成功图片（resultList[].status=1）的 resultList[].id，再调用本接口；主副图复刻结果不支持切分。

请求体

切分规格

高级 A+＋手机 A+生成的两张结果图须分别使用各自的图片 ID 调用。以上是切片规格，生成原图的实际尺寸仍以查询结果为准；如有不足标准高度的尾图，以切片返回的实际宽高为准。

切分示例

以下示例预览高级 A+结果图，请将 imageId 替换为查询得到的成功图片 ID。省略 splitTypes 时使用当前图片支持的规格。

{
  "imageId": 123456789,
  "splitTypes": ["aplus_pro"],
  "recoverMissing": false
}

返回结果

接口直接返回切分结果，data 按规格分组，分组名称对应 aplus、aplus_pro 或 aplus_phone。每组包含以下字段：

图片地址为临时链接，请及时下载保存。地址过期时重新调用本接口刷新；文件缺失时再将 recoverMissing 设为 true。

扣费标准

单价按后台作图模型配置展示，单位为点/张，使用稳定模式扣点。有品质档位的模型按默认 medium 扣点。

商品图数量和 A+模块数量不额外计费。创建时预扣点，失败按平台规则回补，最终扣点以查询结果的 data.count 为准。查询结果不额外扣点。