获取当前已启用的商品场景模板，供创建 goods.scene_effect（场景效果图）时选择 scene_id。

蜂巢 · AI 图片场景列表

一、接口名称

• 接口名称：AI 商品创图 · 场景模板列表
• 接口地址：https://kf.fw199.com/gateway/ai/image/scenes
• 请求方式：POST
• Content-Type：application/x-www-form-urlencoded

推荐流程：

1. 调用本接口拿到场景列表
2. 按 category / product_fit / label_zh 选一个 scene_id
3. 再调用 创建异步任务（task_type=goods.scene_effect）

创建场景图时若省略 scene_id 或传 auto，蜂巢会按商品品类自动选景（默认回落到 studio_white_seamless）。

二、请求参数

公共参数

业务参数

category 常见取值：

说明：

• 本接口只做验签，返回启用中的模板；场景列表本身通常不按次扣费。
• 传入未知 category 时返回空数组（不是错误）。
• 返回顺序按 sort_order 升序。

三、请求示例代码（Java）

3.1 查询全部场景

@Test
public void listAiImageScenes() throws Exception {
    String apiUrl = "https://kf.fw199.com/gateway/ai/image/scenes";

    Map<String, String> data = new HashMap<>();
    data.put("appid", Config.AppId);
    data.put("timestamp", String.valueOf(System.currentTimeMillis() / 1000));
    data.put("sign", Utils.Sign(data, Config.AppSecret));

    String result = doHttpRequest(apiUrl, data);
    System.out.println("result:" + result);
}

3.2 按分类过滤（户外）

@Test
public void listAiImageOutdoorScenes() throws Exception {
    String apiUrl = "https://kf.fw199.com/gateway/ai/image/scenes"; 
    Map<String, String> data = new HashMap<>();
    data.put("appid", Config.AppId);
    data.put("timestamp", String.valueOf(System.currentTimeMillis() / 1000)); 
    data.put("sign", Utils.Sign(data, Config.AppSecret)); 
    String result = doHttpRequest(apiUrl, data);
    System.out.println("result:" + result);
}

四、返回结果

HTTP 状态码始终为 200，业务成败看 JSON 中的 code。

4.1 成功示例

{
    "code": 0,
    "message": "ok",
    "data": [
        {
            "scene_id": "studio_white_seamless",
            "label_zh": "纯白棚拍",
            "description_zh": "通用电商主图风格，干净高亮，适合全品类商品突出主体",
            "category": "studio",
            "product_fit": [
                "general",
                "apparel",
                "shoes",
                "bags",
                "beauty",
                "home"
            ],
            "sort_order": 10,
            "version": 1
        },
        {
            "scene_id": "studio_light_gray",
            "label_zh": "浅灰棚拍",
            "description_zh": "高级灰背景_catalog 风，适合鞋服、3C、家居小件",
            "category": "studio",
            "product_fit": [
                "apparel",
                "shoes",
                "bags",
                "electronics",
                "home"
            ],
            "sort_order": 20,
            "version": 1
        },
        {
            "scene_id": "studio_warm_beige",
            "label_zh": "暖米色棚拍",
            "description_zh": "温暖柔和棚拍，适合家居、美妆、母婴类商品",
            "category": "studio",
            "product_fit": [
                "home",
                "beauty",
                "baby",
                "apparel"
            ],
            "sort_order": 30,
            "version": 1
        },
        {
            "scene_id": "product_pedestal",
            "label_zh": "圆形展台",
            "description_zh": "简约圆形展台陈列，适合鞋、包、美妆、小家电",
            "category": "studio",
            "product_fit": [
                "shoes",
                "bags",
                "beauty",
                "electronics",
                "accessories"
            ],
            "sort_order": 40,
            "version": 1
        },
        {
            "scene_id": "product_marble_pedestal",
            "label_zh": "大理石展台",
            "description_zh": "大理石台面质感，适合美妆、香水、珠宝、高端鞋靴",
            "category": "studio",
            "product_fit": [
                "beauty",
                "jewelry",
                "shoes",
                "bags",
                "luxury"
            ],
            "sort_order": 50,
            "version": 1
        },
        {
            "scene_id": "home_wood_desk",
            "label_zh": "木质桌面",
            "description_zh": "居家木质桌面场景，适合文具、数码配件、小家电、鞋盒展示",
            "category": "indoor",
            "product_fit": [
                "electronics",
                "stationery",
                "home",
                "shoes",
                "accessories"
            ],
            "sort_order": 60,
            "version": 1
        },
        {
            "scene_id": "home_minimal_shelf",
            "label_zh": "极简置物架",
            "description_zh": "简约置物架背景，适合家居、收纳、香薰、杯具",
            "category": "indoor",
            "product_fit": [
                "home",
                "storage",
                "beauty",
                "kitchen"
            ],
            "sort_order": 70,
            "version": 1
        },
        {
            "scene_id": "home_bedside_soft",
            "label_zh": "床边柔光",
            "description_zh": "柔和卧室床边光线，适合拖鞋、家居服、袜品、睡衣",
            "category": "indoor",
            "product_fit": [
                "slippers",
                "apparel",
                "socks",
                "home",
                "baby"
            ],
            "sort_order": 80,
            "version": 1
        },
        {
            "scene_id": "cafe_table_window",
            "label_zh": "窗边咖啡桌",
            "description_zh": "窗边咖啡桌氛围，适合杯具、轻食包装、生活方式类商品",
            "category": "indoor",
            "product_fit": [
                "kitchen",
                "home",
                "food_packaging",
                "accessories"
            ],
            "sort_order": 90,
            "version": 1
        },
        {
            "scene_id": "outdoor_park_grass",
            "label_zh": "公园草地",
            "description_zh": "户外公园草地清晨感，适合运动鞋、户外鞋、野餐用品",
            "category": "outdoor",
            "product_fit": [
                "shoes",
                "outdoor",
                "sports"
            ],
            "sort_order": 100,
            "version": 1
        },
        {
            "scene_id": "outdoor_city_sidewalk",
            "label_zh": "城市步道",
            "description_zh": "城市街拍步道，适合休闲鞋、包袋、潮服生活方式图",
            "category": "outdoor",
            "product_fit": [
                "shoes",
                "bags",
                "apparel",
                "streetwear"
            ],
            "sort_order": 110,
            "version": 1
        },
        {
            "scene_id": "outdoor_sports_court",
            "label_zh": "运动场地",
            "description_zh": "户外运动场地，适合球鞋、运动服、球类配件",
            "category": "outdoor",
            "product_fit": [
                "shoes",
                "sports",
                "apparel",
                "outdoor"
            ],
            "sort_order": 120,
            "version": 1
        }
    ],
    "trace_id": "3780f44b-19d3-4259-8201-051b86e807f2"
}

4.2 data 字段说明

data 为数组，每个元素：