商品套图 V4 API 接口文档

POST/image/v4/make/productMarketMaterialapplication/json

请求体

基础参数

imageListarray[string]必填

商品图片列表，请求张数见下方模型对照表

格式：jpg/jpeg/png/webp大小：单张≤10M尺寸：800×800～4096×4096

sellerPointstring条件必填

商品卖点，≤2500字符（未开启自动提取时必填）

categoryIdstring可选

套图类目 API 返回的 category.categoryId。用于选择商品品类及可用的系统品牌预设。

categoryPathKeystring可选

套图类目 API 返回的 category.pathKey。同一 Amazon 节点存在多条路径时建议同时传入。

brandPresetKeystring可选

系统品牌预设稳定编号；必须与当前 categoryId/categoryPathKey 匹配，且不能与 genId 同时提交。

isExtractPrePointboolean可选默认false

自动提取卖点

providerstring可选

未传时使用当前业务类型的默认启用模型；模型选择，可选值见比例与分辨率；模型特殊参数

aspectRatiostring可选

素材宽高比（卖点图/场景图/特写图），按模型配置校验，支持比例详见比例与分辨率

resolutionstring可选

输出分辨率，详情见比例与分辨率

targetWidthinteger可选

主副图（含商品尺寸图）的目标输出宽度，与 targetHeight 成对提交；取值范围 600 至 4096 像素。

targetHeightinteger可选

主副图（含商品尺寸图）的目标输出高度，与 targetWidth 成对提交；取值范围 600 至 4096 像素。

brandKeyobject可选

品牌基因 JSON 对象

对象字段

brandColorstring[]，可填写多个颜色值，最多 8 个；每个使用 #RRGGBB 格式，例：["#0775FA", "#112233"]

fontStyle字体风格（兼容无衬线体，硬性无衬线体，优雅衬线体）

salesRegion销售地区（例：中东欧）

language语言（例：英语西班牙语）

platform平台（例：亚马逊）

customSettings自定义描述内容

出图数量

至少选择一种图片类型，将对应的出图数量设为 1 或以上；可同时选择多种，未填写的数量按 0 计算。

商品尺寸图使用 productSizeNum=1。{size} 表示商品实物尺寸，来自 sellerPoint 中 [产品尺寸] 后的内容；targetWidth/targetHeight 表示输出图片的像素宽高，两者用途不同。

sellerTypeNuminteger可选默认0

卖点图数量，最大12

sceneTypeNuminteger可选默认0

场景图数量，最大12

closeUpTypeNuminteger可选默认0

特写图数量，最大12

closeUpWhiteTypeNuminteger可选默认0

白底特写图数量，最大12

whiteBgTypeNuminteger可选默认0

白底图数量，最大12

productSizeNuminteger可选

商品尺寸图数量，当前最多 1 张。启用时 sellerPoint 必须包含 [产品尺寸] 标记及商品实物尺寸；输出像素由 targetWidth/targetHeight 控制，与实物尺寸互不影响。

aPlusNuminteger可选默认0

普通A+数量，最大12

aPlusProNuminteger可选默认0

高级A+数量（Pro版），最大12

aPlusCustomNuminteger可选

自定义 A+ 数量，整数 0 至 12。参与总出图数量，并使用 aPlusTargetWidth/aPlusTargetHeight。

aPlusHasPhoneboolean可选默认false

是否生成手机版A+（基于高级A+结果，数量与高级A+一致）

aPlusAspectRatiostring可选

自定义 A+（aPlusCustomNum）可用的页面宽高比；普通/高级/手机 A+ 为固定尺寸，不使用本字段。支持格式：16:9、9:16、1:1、4:3；长边/短边（max/min）≤ 2.5，1:3.7 等超限比例非法。不填则按 aPlusTargetWidth/aPlusTargetHeight 或默认策略。

aPlusTargetWidthinteger可选

自定义 A+ 目标输出宽度，与 aPlusTargetHeight 成对提交；取值范围 600 至 4096 像素。

aPlusTargetHeightinteger可选

自定义 A+ 目标输出高度，与 aPlusTargetWidth 成对提交；取值范围 600 至 4096 像素。

排版样式

noTextboolean可选默认false

无字模式，开启后排版不含文字

aPlusStylesList可选

A+图排版列表，为每张A+图指定排版方式
数量需不少于A+图数量（aPlusNum + aPlusProNum + aPlusCustomNum），每项可填 id 或 prompt

pointStylesList可选

卖点图排版列表，为每张卖点图指定排版方式
数量需不少于卖点图数量（sellerTypeNum），每项可填 id 或 prompt

id ：通过作图素材接口获取（type=10：套图-排版素材），自动取该素材对应的提示词、排版图与缩略图

prompt ：通过图片获取描述词-创建任务接口获取（type=71：商品套图卖点分析），作为该图的排版提示词下发给模型

本示例中的 aPlusStyles 使用接口返回的 A+ 横板排版 ID；pointStyles 使用商品排版（L 系列）ID。排版 ID 需以当前环境中 type=IMAGE_LAYOUT 返回的数据为准。

不传当前参数时使用默认排版，不校验数量。

手动上传排版并提取提示词

如果没有现成的排版素材 ID，也可以先上传自己的排版图片，再提取提示词传入套图接口：

将排版图片上传到可访问的文件地址，得到 layoutImageUrl。上传接口以平台当前文件上传能力为准，本接口不接收图片文件本身。
调用图片获取描述词-创建任务，使用商品套图类型 71，并指定 provider 为 API_LAYOUT_DESC：

使用创建任务返回的 data.id 调用图片获取描述词-获取结果，轮询至 data.status=3，读取 data.result.content。
将提取结果作为排版提示词传入 aPlusStyles 或 pointStyles，例如：

如果排版已通过作图素材接口登记为 type=10，则直接传素材返回的 id；系统会自动读取该素材关联的排版图和提示词。手动上传图片不会自动成为排版素材，也不能把图片 URL 直接填入 aPlusStyles 或 pointStyles。

词库

sensitiveLibraryIdLong可选

敏感词库ID，命中的敏感词会经AI改写规避
不传则不启用该能力

replaceLibraryIdLong可选

替换词库ID，命中的词按预设替换词直接替换
不传则不启用该能力

sensitiveLibraryId：通过作图素材接口获取（type=11：敏感词库），取列表中的 id 字段

replaceLibraryId：通过作图素材接口获取（type=12：替换词库），取列表中的 id 字段

两个词库互相独立，可单独传入其中之一，也可同时传入。

同时传入时依次执行：先用敏感词库检测并经AI改写规避，再按替换词库做替换。替换不依赖改写结果——无论敏感词是否命中、AI改写是否成功，只要传了替换词库就会执行替换。

传入不存在、无权访问，或类型与参数不匹配的ID时，返回参数校验错误。

模型特殊参数

qualitystring可选默认medium

输出品质，支持范围详见比例与分辨率

比例与分辨率

请显式传入所需分辨率。

provider	支持比例	支持分辨率	支持品质	请求图片
正在读取模型配置...

请求示例

GPT系列模型（GPT_2_IMAGE / GPT_2_5_IMAGE）

JSON

{
  "imageList": ["https://test-file-ai.linkfox.com/UPLOAD/MANAGE/7c6b7c7010564aba919ad89dabce4f82.jpg"],
  "sellerPoint": "轻量舒适，透气运动鞋，适合日常穿搭",
  "provider": "GPT_2_IMAGE",
  "resolution": "2K",
  "quality": "high",
  "aPlusNum": 1,
  "sellerTypeNum": 1,
  "aPlusStyles": [{"id":"2015989768887762944"}],
  "pointStyles": [{"id":"2089669664662286337"}]
}

GPT_2_5_IMAGE / GPT_2_5_F_IMAGE 请求参数与上方完全一致，仅将 provider 改为对应模型码。

其他模型

JSON

{
  "imageList": ["https://test-file-ai.linkfox.com/UPLOAD/MANAGE/7c6b7c7010564aba919ad89dabce4f82.jpg"],
  "sellerPoint": "轻量舒适，透气运动鞋，适合日常穿搭",
  "provider": "BANANA_PRO",
  "resolution": "2K",
  "aPlusNum": 1,
  "sellerTypeNum": 1,
  "aPlusStyles": [{"id":"2015989768887762944"}],
  "pointStyles": [{"id":"2089669664662286337"}]
}

提交后返回什么

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

查询生成结果

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

结果图片的素材类型

查询响应结果时，每张图的 extendField.type 字段标明该图属于哪类素材，便于分类识别：

type 值	说明
A+	普通A+：亚马逊A+页面图文营销模块，固定输出 `970×600`
APlusPro	高级A+：A+页面高级图文模块，固定输出 `1464×600`，不支持自定义宽高比
APlusCustom	自定义 A+：可用 `aPlusAspectRatio`（长边/短边 ≤ 2.5）与/或 `aPlusTargetWidth/aPlusTargetHeight`（600～4096）控制输出
APlusHasPhone	手机版A+：基于高级A+生成的手机端适配版本，固定输出 `600×450`
sellPoint	卖点图：突出商品卖点的视觉营销图
scene	场景图：商品置于使用场景中的展示图
closeUp	特写图：商品局部细节特写
closeUpWhite	白底特写图：白底的商品局部特写
whiteBg	白底图：商品精修白底主图
size_chart	商品尺寸图：按商品实物尺寸生成标注图，输出像素由 `targetWidth/targetHeight` 决定

A+ 图片按业务规格固定输出：普通 A+ 为 970×600，高级 A+ 为 1464×600，手机版 A+ 为 600×450，不受 targetWidth/targetHeight 影响。

aPlusAspectRatio 仅用于自定义 A+（aPlusCustomNum）的宽高比；长边/短边 ≤ 2.5（如 16:9、9:16、1:1、4:3；1:3.7 非法）。普通/高级/手机 A+ 不受该字段影响。自定义最终像素时可同时传入成对的 aPlusTargetWidth/aPlusTargetHeight（600 至 4096）。

扣费标准

正在读取当前模型扣点...

按各类素材实际生成张数累计扣点。

创建上限

配置项	上限
创建中 / 生成中任务上限	30 个