跳转到主要内容
商品 AI 分析、商品图片 AI 策划和 A+ AI 策划均为同步接口:HTTP 请求会在结果准备完成后返回,不需要查询任务状态。客户端超时时间建议设置为至少 120 秒。

商品 AI 分析

商品分析根据 1 至 15 张商品图片,返回结构化商品事实与内容策划依据。
响应包含两种使用方式:
  • analysis:结构化 JSON,适合程序继续处理。
  • formattedText / output_text:格式化文本,适合直接展示、编辑或作为后续简报。
analysis.attributes[].evidence 的含义:

商品图片 AI 策划

商品图片策划会先为整批任务识别不可改变的商品边界,再为每张计划生成的图片分配不同的内容重点、视觉方向和原图处理方式。它只返回策划,不会创建生图任务,也不需要轮询。 至少需要 1 张 product_image_urls 和 2 项 tasks。商品图、视觉参考图和排版图合计最多 15 张。
data.product_boundary 说明商品主体、可替换内容和可确认随售部件;data.assignments 通过 task_key 与请求任务一一对应。调用方应检查或编辑策划,再把对应的 primary_focus、visual_direction、supporting_details 和 source_content_action 整理成生图接口的 prompt。

支持的商品图片类型

A+ AI 策划

A+ 策划需要至少一张商品图片和至少一个模块标识。建议把商品分析结果整理成 product_description 传入。
策划成功后:
  • 将 modules[].recommended_prompt 传给对应 A+ 生图请求的 plan_prompt。
  • 将 global_style 传给每个 A+ 生图请求的 series_style_guide。
  • 人工检查 notes,确认产品事实、平台规则和合规限制。
策划请求应填写后续使用的生图模型:gpt-image-2 最多接收 15 张商品图,nano-banana-2-lite、nano-banana-2 和 nano-banana-pro 最多接收 14 张。

支持的 A+ 模块