电商套图生成

POST /images/ecommerce/generate

上传商品原图，一键生成符合电商平台规范的套图（主图、场景图、详情页），内置各大平台尺寸与白底规范。

接口信息

项目	说明
接口地址	POST https://api.seeany.com/v1/images/ecommerce/generate
Content-Type	multipart/form-data
认证方式	Bearer Token
超时时间	120 秒

请求参数

参数	类型	必填	说明
image	file	✅	商品原图，支持 JPG/PNG/WebP，最大 10MB
platform	string	❌	目标平台：amazon(默认) / taobao / tmall
package	string	❌	出图类型：full(默认，9张) / main_only / scene_only
style	string	❌	视觉风格：minimal(默认) / lifestyle / luxury
model	string	❌	生成模型，默认 nano-banana-pro

请求示例

Python

from seeany import SeeAny

client = SeeAny(api_key="sk-xxxxx")

result = client.images.ecommerce.generate(
    image=open("./product.jpg", "rb"),
    platform="amazon",
    package="full",
    style="minimal"
)

for img in result.images:
    print(f"{img.description}: {img.url}")
print(f"总费用: ¥{result.total_cost.amount}")

cURL

curl -X POST https://api.seeany.com/v1/images/ecommerce/generate \
  -H "Authorization: Bearer sk-xxxxx" \
  -F "image=@./product.jpg" \
  -F "platform=amazon" \
  -F "package=full" \
  -F "style=minimal"

响应示例

{
  "id": "ecom_20260603_001",
  "object": "ecommerce_suite",
  "status": "completed",
  "platform": "amazon",
  "images": [
    {
      "type": "main",
      "description": "主图 - 白底",
      "size": "2000x2000",
      "url": "https://cdn.seeany.com/ecom/ecom_001/main_white.png"
    },
    {
      "type": "main",
      "description": "主图 - 场景",
      "size": "2000x2000",
      "url": "https://cdn.seeany.com/ecom/ecom_001/main_scene.png"
    },
    {
      "type": "scene",
      "description": "场景图 - 生活使用",
      "size": "2000x2000",
      "url": "https://cdn.seeany.com/ecom/ecom_001/scene_lifestyle.png"
    },
    {
      "type": "detail",
      "description": "详情页 - 卖点展示",
      "size": "790x1200",
      "url": "https://cdn.seeany.com/ecom/ecom_001/detail_01.png"
    }
  ],
  "total_cost": { "amount": 1.50, "currency": "CNY" }
}

出图说明

Amazon 套图（full）

序号	类型	尺寸	说明
1	主图	2000x2000	纯白底，无文字
2	主图	2000x2000	场景化主图
3	场景图	2000x2000	使用场景
4	场景图	2000x2000	细节特写
5	场景图	2000x2000	尺寸对比
6-9	详情页	790x1200	卖点展示图 × 4

淘宝 / 天猫 套图

序号	类型	尺寸	说明
1	主图	800x800	白底主图
2	主图	800x800	卖点图
3-5	场景图	800x800	使用场景 × 3
6-9	详情页	790x自适应	详情页切片 × 4

提示

• 原图质量越高，生成效果越好
• 建议上传正面、无遮挡的商品图
• 资源 URL 有效期 7 天