跳转到主要内容
POST
提交 A+ 图片生成任务

授权

Authorization
string
header
必填

成员级 Public API Key。请填写完整密钥,Mintlify Playground 会自动以 Authorization: Bearer <PUBLIC_API_KEY> 发送。完整明文只在管理后台创建成功时显示一次。

请求体

application/json
module_key
enum<string>
必填

A+ 模块标识。枚举值与模块名称对应关系:

  • hero:首屏主视觉
  • core:核心卖点图
  • usage:使用场景图
  • angles:多角度图
  • mood:场景氛围图
  • detail:商品细节图
  • brand:品牌故事图
  • size:尺寸/容量/尺码图
  • compare:效果对比图
  • specs:详细规格/参数表
  • process:工艺制作图
  • accessories:配件/赠品图
  • series:系列展示图
  • ingredients:商品成分图
  • care:售后保障图
  • tips:使用建议图
可用选项:
hero,
core,
usage,
angles,
mood,
detail,
brand,
size,
compare,
specs,
process,
accessories,
series,
ingredients,
care,
tips
image_urls
string<uri>[]
必填

商品图 URL。gpt-image-2 最多 15 张,三个 Banana 模型最多 14 张。

Required array length: 1 - 15 elements
target_size
enum<string>

A+ 最终交付版式尺寸。省略时使用所选模块的默认尺寸。

可用选项:
1464x600,
970x600,
970x300,
600x450,
463x625,
220x220,
150x300
generation_size
string

可选的模型原生生成比例。通常无需填写;如果填写,必须与 target_size 和 model 的平台映射一致。

示例:

"3:2"

model
enum<string>
默认值:gpt-image-2

A+ 生图模型。不同模型支持的图片数量和分辨率不同。

可用选项:
gpt-image-2,
nano-banana-2-lite,
nano-banana-2,
nano-banana-pro
product_brief
string

商品简报。未传入 plan_prompt 时强烈建议提供。

Maximum string length: 2000
module_note
string

当前模块的补充要求。

platform
string
默认值:Amazon

目标电商平台。

market
string

目标市场或国家。

language
string
默认值:zh-CN

图片文案语言;使用 no-text 可要求纯视觉画面。

resolution
enum<string>
默认值:1k

输出分辨率。0.5k 仅部分模型支持。

可用选项:
0.5k,
1k,
2k,
4k
plan_prompt
string

A+ 策划接口返回的 recommended_prompt,或客户编辑后的模块提示词。

negative_prompt
string

不希望图片中出现的内容和表现方式。

series_style_guide
string

A+ 策划接口返回的 global_style,用于保持多模块视觉一致。

响应

查询任务结果

任务提交成功后返回 data.task_id。请保存该任务编号,并通过 GET /v1/open/tasks/{task_id} 轮询任务状态,详见查询生图任务。

code
integer
必填

HTTP 状态码。任务接受时为 200。

data
object
必填
request_id
string
必填

本次请求的诊断编号。联系平台排查问题时请提供,不要记录 Public API Key。

示例:

"req_550e8400-e29b-41d4-a716-446655440000"