电商图片 API

外部服务可以通过公开 API 生成电商商品图。请求使用 API 密钥鉴权，并消耗该 API 密钥所属账号的 credits。

鉴权

在 设置 > API 密钥 创建密钥。API 密钥功能需要设置 NEXT_PUBLIC_ENABLE_API_KEYS=true。

通过以下任一请求头传入密钥：

Authorization: Bearer YOUR_API_KEY

或：

x-api-key: YOUR_API_KEY

创建任务

POST /api/v1/ecommerce-images/jobs

请求体使用 multipart/form-data。

字段	类型	必填	说明
`payload`	JSON 字符串	是	生成参数、模型和分辨率。
`referenceImages`	文件数组	是	商品参考图，可重复传多个同名字段。支持 JPEG、PNG 和 WebP。

curl -X POST https://lbanai.com/api/v1/ecommerce-images/jobs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F 'payload={"input":{"productName":"Travel Mug","brandName":"Acme","category":"Drinkware","market":"global","platforms":["amazon"],"style":"clean_white","outputs":["main_image"],"variantCount":1,"detailPageMode":"auto","sellingPoints":"Leak-proof lid, stainless steel body","mustKeep":"Keep the original mug shape and logo","avoid":"No extra accessories","textOverlay":"","authorizationConfirmed":true},"model":"gpt-image-2.5-flare","resolution":"1k"}' \
  -F "referenceImages=@product.png"

参考图字段

referenceImages 是商品外观、材质、颜色、结构和包装的主要依据。请求中至少需要 1 张参考图，否则接口会返回 400。

项目	说明
表单字段名	`referenceImages`。多图时重复传同名字段，例如 `-F "referenceImages=@front.png" -F "referenceImages=@side.png"`。
兼容字段	`referenceImage` 也可传单张图片，但新接入建议统一使用 `referenceImages`。
支持格式	JPEG、PNG、WebP。
单张大小	最大 4 MB。
数量限制	取决于 `model`：GPT Image 2.5 最多支持 16 张，其他列出的模型最多支持 10 张。
授权要求	`payload.input.authorizationConfirmed` 必须为 `true`，表示你有权使用参考图、品牌元素、文案和 IP。
生成影响	系统会优先保留商品主体、颜色、结构、Logo/包装等关键元素；可用 `mustKeep` 强化必须保留项，用 `avoid` 排除不希望出现的元素。

成功响应包含：

字段	说明
`jobId`	生成任务 ID，可用于查询任务详情。
`status`	`completed`、`partial_failed`、`failed` 或 `blocked`。
`assets`	生成结果；成功时包含图片 URL。
`consumedCredits`	成功生成资产实际消耗的 credits。
`complianceReport`	本次请求的合规检查结果。

Payload

payload 是 JSON 字符串，结构如下：

{
  "input": {
    "productName": "Travel Mug",
    "brandName": "Acme",
    "category": "Drinkware",
    "market": "global",
    "platforms": ["amazon"],
    "style": "clean_white",
    "outputs": ["main_image"],
    "variantCount": 1,
    "detailPageMode": "auto",
    "sellingPoints": "Leak-proof lid, stainless steel body",
    "mustKeep": "Keep the original mug shape and logo",
    "avoid": "No extra accessories",
    "textOverlay": "",
    "authorizationConfirmed": true
  },
  "model": "gpt-image-2.5-flare",
  "resolution": "1k"
}

Input 字段

字段	类型	必填	限制 / 可选值
`productName`	string	是	2-120 个字符。
`brandName`	string	否	最多 80 个字符；不需要时传 `""`。
`category`	string	是	2-120 个字符。
`market`	enum	是	见下方市场枚举。
`platforms`	enum[]	是	1-4 个平台；见下方平台枚举。
`style`	enum	是	见下方风格枚举。
`outputs`	enum[]	是	一个或多个输出类型。
`variantCount`	number	是	1 到 5 的整数。
`detailPageMode`	enum	否	`auto`、`technical`、`standard`、`kids`；默认 `auto`。
`sellingPoints`	string	否	最多 800 个字符。
`mustKeep`	string	否	最多 500 个字符。
`avoid`	string	否	最多 500 个字符。
`textOverlay`	string	否	最多 240 个字符。
`authorizationConfirmed`	boolean	是	使用参考图时必须确认你拥有使用权。

枚举值

`market` 目标市场

目标市场会影响平台提示词里的语言、审美方向、合规提醒和默认电商语境。

值	界面名称	适用说明
`north_america`	北美	面向美国、加拿大等北美市场，偏标准零售、清晰可信的商品表达。
`europe`	欧洲	面向欧洲市场，偏克制、规范、环保或品质感表达。
`southeast_asia`	东南亚	面向 Shopee、Lazada 等东南亚跨境场景，画面更明亮、移动端友好。
`southeast_asia_chinese`	东南亚华人市场	面向东南亚华人消费语境，适合中文卖点、节庆或华人生活方式表达。
`mainland_china`	中国大陆	面向淘宝、京东、拼多多、抖音、快手、小红书等中国大陆平台。
`japan`	日本	面向日本市场，偏干净、细节明确、低噪音和可信赖的商品呈现。
`korea`	韩国	面向韩国市场，偏潮流、精致、美妆/生活方式视觉语境。
`middle_east`	中东	面向中东市场，注意保守审美、礼仪和本地文化敏感项。
`brazil`	巴西	面向巴西市场，适合更鲜明、热情、生活化的消费场景。
`global`	全球	通用跨境市场，不绑定单一区域；适合多平台或不确定目标市场时使用。

`platforms` 平台

平台会决定画幅、背景、商品占比、是否允许叠字和禁用项。当前 API 支持传 1-4 个平台；每个平台都会生成对应平台规则下的资产。

值	界面名称	画幅	背景 / 场景	文字规则	商品呈现规则
`amazon`	Amazon	`1:1`	纯白 `#FFFFFF`	不允许文字、Logo、水印、价格。	商品居中，至少占画面 85%。
`shopee`	Shopee	`1:1`	白底或生活方式场景	可少量叠字，最多约 20%，不能误导价格。	商品至少占画面 70%，适合移动端缩略图。
`tiktok_shop`	TikTok Shop	`1:1`	真实生活方式场景	可叠字，最多约 15%。	强调真实使用感，商品要在场景中清晰可见。
`kuaishou`	快手	`1:1`	真实使用场景或明亮电商背景	可放简短利益点，最多约 20%，不能虚假宣传。	画面务实、可信，适合信息流缩略图。
`douyin`	抖音	`1:1`	潮流生活方式场景	可放短促卖点，最多约 15%，不能夸大承诺。	商品必须一眼可识别，适合内容电商节奏。
`xiaohongshu`	小红书	`3:4`	干净生活方式笔记场景	可放轻量标注，避免强促销口吻。	自然陈列，偏发现感、精致但亲和。
`taobao`	淘宝	`1:1`	白底、浅色纯色或精修生活方式场景	可放促销文字，最多约 20%，不能误导价格。	商品至少占画面 70%，主图识别清晰。
`pinduoduo`	拼多多	`1:1`	明亮、干净、突出性价比的背景	可放利益点，最多约 20%，不能夸大。	商品清楚，突出实用和价格友好感。
`jd`	京东	`1:1`	白底或高级浅色影棚背景	仅允许有限功能性文字，不能夸大。	商品居中、细节锐利，强调品质和可信赖。
`lazada`	Lazada	`1:1`	干净纯白背景	主图不应有店铺水印；可有有限功能性文字。	商品至少占画面 80%，清晰专业。
`aliexpress`	AliExpress	`1:1`	纯白或浅灰纯色背景	普通店铺主图不放文字、水印、Logo 或价格标签。	国际跨境风格，商品居中、信息干净。
`temu`	Temu	`1:1`	明亮白底或浅色纯色背景	可叠字，最多约 20%，不能夸大宣传。	商品清楚，偏高性价比、移动端友好。
`shein`	SHEIN	`3:4`	白底或简单时尚场景	可叠字，最多约 15%。	年轻快时尚构图，避免杂乱背景。

`style` 风格

传 auto 时系统会根据 category 自动推荐风格；也可以传固定风格以获得更可控的视觉方向。

值	界面名称	适合场景	常见适用平台
`auto`	自动	根据品类自动选择：数码/工具偏白底，美妆/家居/服饰偏生活方式，儿童/文具偏插画，珠宝/手表偏轻奢。	所有平台
`clean_white`	极简白底	标准电商主图、白底影棚、商品边缘清晰、干净无干扰。	Amazon、AliExpress、Temu、Lazada、Shopee、淘宝、拼多多、京东
`lifestyle`	生活场景	真实使用环境、自然光、商品融入生活场景但仍保持商业质感。	Shopee、TikTok Shop、快手、抖音、小红书、淘宝、SHEIN、Lazada
`premium_minimal`	轻奢简约	高客单、礼品、珠宝、美妆等需要留白、低饱和和精致阴影的视觉。	Amazon、AliExpress、Shopee、小红书、淘宝、京东、Lazada、SHEIN
`bold_vibrant`	活力色彩	高对比、饱和色、促销感强，适合移动端缩略图和活动图。	Shopee、Temu、TikTok Shop、快手、抖音、淘宝、拼多多、SHEIN
`illustrated`	手绘插画	儿童、文具、礼品或创意商品；会在真实商品周围加入友好的插画元素。	Shopee、TikTok Shop、抖音、小红书
`ugc_rush`	快节奏带货	真实、轻微不完美、类似用户生成内容，适合短视频电商带货素材。	TikTok Shop、快手、抖音、SHEIN

`outputs` 产出类型

值	界面名称	说明
`main_image`	主图	按平台规则生成商品主图，通常最严格遵守背景、画幅和商品占比要求。
`variant`	变体图	围绕同一商品生成不同构图或场景版本；数量受 `variantCount` 控制。
`detail_page`	详情页	生成更偏详情页/卖点展示的图片，会参考 `detailPageMode`。

`detailPageMode` 详情页模式

值	说明
`auto`	自动选择详情页表达方式，适合大多数商品。
`technical`	技术/参数型详情页，适合数码、工具、家电、功能型商品。
`standard`	标准卖点型详情页，适合日用品、家居、美妆、服饰等通用商品。
`kids`	儿童/家庭友好型详情页，适合童装、玩具、母婴、文具等品类。

模型

模型	分辨率	参考图数量限制
`nano-banana-2`	`0.5k`、`1k`、`2k`、`4k`	最多 14 张
`nano-banana-2-ext`	`0.5k`、`1k`、`2k`、`4k`	最多 14 张
`gpt-image-2.5-flare`	`1k`、`2k`、`4k`	最多 16 张
`gpt-image-2.5-sunburst`	`1k`、`2k`、`4k`	最多 16 张
`seedream-5-0-flash`	`1k`、`1.5k`、`2k`	最多 10 张
`seedream-5-0-pro`	`1k`、`1.5k`、`2k`	最多 10 张
`seedream-5-0-lite`	`2k`、`3k`、`4k`	最多 10 张
`flux-2-pro`	`1mp`、`2mp`、`3mp`、`4mp`	最多 8 张

画幅会与分辨率组合校验。省略 resolution 时，接口使用该模型配置的默认值。当前活动模型均通过 APIMart 图片接口调用。Nano Banana 2 支持 auto、1:1、 3:2、2:3、4:3、3:4、16:9、9:16、5:4、4:5、21:9、1:4、 4:1、1:8、8:1。GPT Image 2.5 支持 auto、1:1、3:2、2:3、4:3、 3:4、5:4、4:5、16:9、9:16、2:1、1:2、21:9、9:21、3:1、 1:3。Seedream 5.0 支持 auto、1:1、 3:2、2:3、4:3、3:4、16:9、9:16、21:9。FLUX.2 Pro 支持 1:1、 3:2、2:3、4:3、3:4、5:4、4:5、16:9、9:16（不支持 auto）。

查询任务

GET /api/v1/ecommerce-images/jobs/:id

curl https://lbanai.com/api/v1/ecommerce-images/jobs/JOB_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

只能查询该 API 密钥所属账号创建的任务。

错误码

状态码	含义
`400`	payload 或表单数据无效。
`401`	API 密钥缺失、无效或未启用。
`402`	账号 credits 不足。
`404`	当前账号下未找到该任务。
`422`	合规检查拦截该任务。
`500`	生成或存储失败。

电商图片 API

外部服务可以通过公开 API 生成电商商品图。请求使用 API 密钥鉴权，并消耗该 API 密钥所属账号的 credits。

鉴权

在 设置 > API 密钥 创建密钥。API 密钥功能需要设置 NEXT_PUBLIC_ENABLE_API_KEYS=true。

通过以下任一请求头传入密钥：

Authorization: Bearer YOUR_API_KEY

或：

x-api-key: YOUR_API_KEY

创建任务

POST /api/v1/ecommerce-images/jobs

请求体使用 multipart/form-data。

字段	类型	必填	说明
`payload`	JSON 字符串	是	生成参数、模型和分辨率。
`referenceImages`	文件数组	是	商品参考图，可重复传多个同名字段。支持 JPEG、PNG 和 WebP。

curl -X POST https://lbanai.com/api/v1/ecommerce-images/jobs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F 'payload={"input":{"productName":"Travel Mug","brandName":"Acme","category":"Drinkware","market":"global","platforms":["amazon"],"style":"clean_white","outputs":["main_image"],"variantCount":1,"detailPageMode":"auto","sellingPoints":"Leak-proof lid, stainless steel body","mustKeep":"Keep the original mug shape and logo","avoid":"No extra accessories","textOverlay":"","authorizationConfirmed":true},"model":"gpt-image-2.5-flare","resolution":"1k"}' \
  -F "referenceImages=@product.png"

参考图字段

referenceImages 是商品外观、材质、颜色、结构和包装的主要依据。请求中至少需要 1 张参考图，否则接口会返回 400。

项目	说明
表单字段名	`referenceImages`。多图时重复传同名字段，例如 `-F "referenceImages=@front.png" -F "referenceImages=@side.png"`。
兼容字段	`referenceImage` 也可传单张图片，但新接入建议统一使用 `referenceImages`。
支持格式	JPEG、PNG、WebP。
单张大小	最大 4 MB。
数量限制	取决于 `model`：GPT Image 2.5 最多支持 16 张，其他列出的模型最多支持 10 张。
授权要求	`payload.input.authorizationConfirmed` 必须为 `true`，表示你有权使用参考图、品牌元素、文案和 IP。
生成影响	系统会优先保留商品主体、颜色、结构、Logo/包装等关键元素；可用 `mustKeep` 强化必须保留项，用 `avoid` 排除不希望出现的元素。

成功响应包含：

字段	说明
`jobId`	生成任务 ID，可用于查询任务详情。
`status`	`completed`、`partial_failed`、`failed` 或 `blocked`。
`assets`	生成结果；成功时包含图片 URL。
`consumedCredits`	成功生成资产实际消耗的 credits。
`complianceReport`	本次请求的合规检查结果。

Payload

payload 是 JSON 字符串，结构如下：

{
  "input": {
    "productName": "Travel Mug",
    "brandName": "Acme",
    "category": "Drinkware",
    "market": "global",
    "platforms": ["amazon"],
    "style": "clean_white",
    "outputs": ["main_image"],
    "variantCount": 1,
    "detailPageMode": "auto",
    "sellingPoints": "Leak-proof lid, stainless steel body",
    "mustKeep": "Keep the original mug shape and logo",
    "avoid": "No extra accessories",
    "textOverlay": "",
    "authorizationConfirmed": true
  },
  "model": "gpt-image-2.5-flare",
  "resolution": "1k"
}

Input 字段

字段	类型	必填	限制 / 可选值
`productName`	string	是	2-120 个字符。
`brandName`	string	否	最多 80 个字符；不需要时传 `""`。
`category`	string	是	2-120 个字符。
`market`	enum	是	见下方市场枚举。
`platforms`	enum[]	是	1-4 个平台；见下方平台枚举。
`style`	enum	是	见下方风格枚举。
`outputs`	enum[]	是	一个或多个输出类型。
`variantCount`	number	是	1 到 5 的整数。
`detailPageMode`	enum	否	`auto`、`technical`、`standard`、`kids`；默认 `auto`。
`sellingPoints`	string	否	最多 800 个字符。
`mustKeep`	string	否	最多 500 个字符。
`avoid`	string	否	最多 500 个字符。
`textOverlay`	string	否	最多 240 个字符。
`authorizationConfirmed`	boolean	是	使用参考图时必须确认你拥有使用权。

枚举值

`market` 目标市场

目标市场会影响平台提示词里的语言、审美方向、合规提醒和默认电商语境。

值	界面名称	适用说明
`north_america`	北美	面向美国、加拿大等北美市场，偏标准零售、清晰可信的商品表达。
`europe`	欧洲	面向欧洲市场，偏克制、规范、环保或品质感表达。
`southeast_asia`	东南亚	面向 Shopee、Lazada 等东南亚跨境场景，画面更明亮、移动端友好。
`southeast_asia_chinese`	东南亚华人市场	面向东南亚华人消费语境，适合中文卖点、节庆或华人生活方式表达。
`mainland_china`	中国大陆	面向淘宝、京东、拼多多、抖音、快手、小红书等中国大陆平台。
`japan`	日本	面向日本市场，偏干净、细节明确、低噪音和可信赖的商品呈现。
`korea`	韩国	面向韩国市场，偏潮流、精致、美妆/生活方式视觉语境。
`middle_east`	中东	面向中东市场，注意保守审美、礼仪和本地文化敏感项。
`brazil`	巴西	面向巴西市场，适合更鲜明、热情、生活化的消费场景。
`global`	全球	通用跨境市场，不绑定单一区域；适合多平台或不确定目标市场时使用。

`platforms` 平台

平台会决定画幅、背景、商品占比、是否允许叠字和禁用项。当前 API 支持传 1-4 个平台；每个平台都会生成对应平台规则下的资产。

值	界面名称	画幅	背景 / 场景	文字规则	商品呈现规则
`amazon`	Amazon	`1:1`	纯白 `#FFFFFF`	不允许文字、Logo、水印、价格。	商品居中，至少占画面 85%。
`shopee`	Shopee	`1:1`	白底或生活方式场景	可少量叠字，最多约 20%，不能误导价格。	商品至少占画面 70%，适合移动端缩略图。
`tiktok_shop`	TikTok Shop	`1:1`	真实生活方式场景	可叠字，最多约 15%。	强调真实使用感，商品要在场景中清晰可见。
`kuaishou`	快手	`1:1`	真实使用场景或明亮电商背景	可放简短利益点，最多约 20%，不能虚假宣传。	画面务实、可信，适合信息流缩略图。
`douyin`	抖音	`1:1`	潮流生活方式场景	可放短促卖点，最多约 15%，不能夸大承诺。	商品必须一眼可识别，适合内容电商节奏。
`xiaohongshu`	小红书	`3:4`	干净生活方式笔记场景	可放轻量标注，避免强促销口吻。	自然陈列，偏发现感、精致但亲和。
`taobao`	淘宝	`1:1`	白底、浅色纯色或精修生活方式场景	可放促销文字，最多约 20%，不能误导价格。	商品至少占画面 70%，主图识别清晰。
`pinduoduo`	拼多多	`1:1`	明亮、干净、突出性价比的背景	可放利益点，最多约 20%，不能夸大。	商品清楚，突出实用和价格友好感。
`jd`	京东	`1:1`	白底或高级浅色影棚背景	仅允许有限功能性文字，不能夸大。	商品居中、细节锐利，强调品质和可信赖。
`lazada`	Lazada	`1:1`	干净纯白背景	主图不应有店铺水印；可有有限功能性文字。	商品至少占画面 80%，清晰专业。
`aliexpress`	AliExpress	`1:1`	纯白或浅灰纯色背景	普通店铺主图不放文字、水印、Logo 或价格标签。	国际跨境风格，商品居中、信息干净。
`temu`	Temu	`1:1`	明亮白底或浅色纯色背景	可叠字，最多约 20%，不能夸大宣传。	商品清楚，偏高性价比、移动端友好。
`shein`	SHEIN	`3:4`	白底或简单时尚场景	可叠字，最多约 15%。	年轻快时尚构图，避免杂乱背景。

`style` 风格

传 auto 时系统会根据 category 自动推荐风格；也可以传固定风格以获得更可控的视觉方向。

值	界面名称	适合场景	常见适用平台
`auto`	自动	根据品类自动选择：数码/工具偏白底，美妆/家居/服饰偏生活方式，儿童/文具偏插画，珠宝/手表偏轻奢。	所有平台
`clean_white`	极简白底	标准电商主图、白底影棚、商品边缘清晰、干净无干扰。	Amazon、AliExpress、Temu、Lazada、Shopee、淘宝、拼多多、京东
`lifestyle`	生活场景	真实使用环境、自然光、商品融入生活场景但仍保持商业质感。	Shopee、TikTok Shop、快手、抖音、小红书、淘宝、SHEIN、Lazada
`premium_minimal`	轻奢简约	高客单、礼品、珠宝、美妆等需要留白、低饱和和精致阴影的视觉。	Amazon、AliExpress、Shopee、小红书、淘宝、京东、Lazada、SHEIN
`bold_vibrant`	活力色彩	高对比、饱和色、促销感强，适合移动端缩略图和活动图。	Shopee、Temu、TikTok Shop、快手、抖音、淘宝、拼多多、SHEIN
`illustrated`	手绘插画	儿童、文具、礼品或创意商品；会在真实商品周围加入友好的插画元素。	Shopee、TikTok Shop、抖音、小红书
`ugc_rush`	快节奏带货	真实、轻微不完美、类似用户生成内容，适合短视频电商带货素材。	TikTok Shop、快手、抖音、SHEIN

`outputs` 产出类型

值	界面名称	说明
`main_image`	主图	按平台规则生成商品主图，通常最严格遵守背景、画幅和商品占比要求。
`variant`	变体图	围绕同一商品生成不同构图或场景版本；数量受 `variantCount` 控制。
`detail_page`	详情页	生成更偏详情页/卖点展示的图片，会参考 `detailPageMode`。

`detailPageMode` 详情页模式

值	说明
`auto`	自动选择详情页表达方式，适合大多数商品。
`technical`	技术/参数型详情页，适合数码、工具、家电、功能型商品。
`standard`	标准卖点型详情页，适合日用品、家居、美妆、服饰等通用商品。
`kids`	儿童/家庭友好型详情页，适合童装、玩具、母婴、文具等品类。

模型

模型	分辨率	参考图数量限制
`nano-banana-2`	`0.5k`、`1k`、`2k`、`4k`	最多 14 张
`nano-banana-2-ext`	`0.5k`、`1k`、`2k`、`4k`	最多 14 张
`gpt-image-2.5-flare`	`1k`、`2k`、`4k`	最多 16 张
`gpt-image-2.5-sunburst`	`1k`、`2k`、`4k`	最多 16 张
`seedream-5-0-flash`	`1k`、`1.5k`、`2k`	最多 10 张
`seedream-5-0-pro`	`1k`、`1.5k`、`2k`	最多 10 张
`seedream-5-0-lite`	`2k`、`3k`、`4k`	最多 10 张
`flux-2-pro`	`1mp`、`2mp`、`3mp`、`4mp`	最多 8 张

查询任务

GET /api/v1/ecommerce-images/jobs/:id

curl https://lbanai.com/api/v1/ecommerce-images/jobs/JOB_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

只能查询该 API 密钥所属账号创建的任务。

错误码

状态码	含义
`400`	payload 或表单数据无效。
`401`	API 密钥缺失、无效或未启用。
`402`	账号 credits 不足。
`404`	当前账号下未找到该任务。
`422`	合规检查拦截该任务。
`500`	生成或存储失败。

电商图片 API

电商图片 API

鉴权

创建任务

参考图字段

Payload

Input 字段

枚举值

`market` 目标市场

`platforms` 平台

`style` 风格

`outputs` 产出类型

`detailPageMode` 详情页模式

模型

查询任务

错误码

目录

电商图片 API

电商图片 API

鉴权

创建任务

参考图字段

Payload

Input 字段

枚举值

`market` 目标市场

`platforms` 平台

`style` 风格

`outputs` 产出类型

`detailPageMode` 详情页模式

模型

查询任务

错误码

目录