跳转到主要内容
POST
商品图片 AI 策划

授权

Authorization
string
header
必填

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

请求体

application/json
product_image_urls
string<uri>[]
必填

商品主体图片 URL,至少 1 张。商品图、参考图和排版图合计最多 15 张。

Required array length: 1 - 15 elements
tasks
object[]
必填

需要策划的图片任务。task_key 在本次请求内必须唯一。

Required array length: 2 - 160 elements
product_info
object

已知的结构化商品信息。所有数据应来自客户资料或可确认事实。

reference_image_urls
string<uri>[]

视觉风格或构图参考图片 URL。与其他图片合计不得超过 15 张。

Maximum array length: 14
layout_image_urls
string<uri>[]

排版参考图 URL。任务通过 layout_image_index 按从 1 开始的序号引用;与其他图片合计不得超过 15 张。

Maximum array length: 14
global_prompt
string

整批图片统一遵守的视觉风格、商品事实或禁止项。

Maximum string length: 3000
output_language
enum<string>
默认值:zh-cn

图片策划中的目标文案语言;枚举含义与商品图片生成接口一致。

可用选项:
no-text,
thai,
indonesian,
vietnamese,
malay,
zh-cn,
english,
japanese,
korean,
filipino,
zh-tw,
french,
spanish,
german,
italian,
portuguese,
russian,
arabic

响应

批次策划完成。

code
integer
必填

HTTP 状态码。成功时为 200。

data
object
必填
request_id
string
必填

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

示例:

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