支持 1-4 张商品参考图，可额外上传 1 张模板图；不传模板图时支持 1k / 2k 分辨率，返回 10 张详情图和 1 个 PSD 文件。
提交任务
提交一键详情图任务。适用于商品详情页素材生成，完成后返回 10 张详情图和 PSD。
POST/api/third-party/genDetail/generate
请求头
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| X-API-Token | string | 是 | 平台提供的调用凭证，用于识别当前账号或租户。 |
| Content-Type | string | 是 | 提交任务时固定使用 application/json。 |
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| prompt | string | 是 | 详情页生成提示词，建议包含商品卖点、页面风格和内容重点。 |
| images | string[] | 是 | 商品参考图 URL 列表，支持 1-4 张。 |
| resolution | string | 否 | 无模板图时支持 1k / 2k。 |
| templateImage | string | 否 | 详情页模板图 URL，传入后会参考模板结构生成。 |
请求示例
bash
curl -X POST "https://yunfanzhilian.com/api/third-party/genDetail/generate" \
-H "X-API-Token: your_token" \
-H "Content-Type: application/json" \
-d '{
"prompt": "为护肤精华生成电商详情页，突出成分、功效、质地、使用场景和信任背书，整体风格极简高级",
"images": [
"https://your-cdn.com/product-1.jpg",
"https://your-cdn.com/product-2.jpg",
"https://your-cdn.com/product-3.jpg"
],
"resolution": "1k",
"templateImage": "https://your-cdn.com/detail-template.png"
}'响应字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| code | number | - | 业务状态码，200 表示请求成功。 |
| message | string | - | 本次请求的结果说明。 |
| data.taskId | string | - | 任务 ID。提交成功后请保存，用于查询生成结果。 |
| data.recordId | string | - | 生成记录 ID，可用于问题排查和记录追踪。 |
| data.status | string | - | 任务初始状态，通常为 pending 或 processing。 |
| timestamp | string | - | 响应时间，ISO 8601 格式。 |
响应示例
json
{
"code": 200,
"message": "一键详情图任务已提交",
"data": {
"taskId": "task_xxxxxxxx",
"recordId": "67f0c1d6f4a0d2b4d1d0c002",
"status": "pending",
"estimatedTime": "60-180秒",
"images": [
"https://your-cdn.com/product-1.jpg",
"https://your-cdn.com/product-2.jpg",
"https://your-cdn.com/product-3.jpg"
],
"resolution": "1k",
"templateImage": "https://your-cdn.com/detail-template.png"
},
"timestamp": "2026-03-31T09:35:00.000Z"
}注意事项
- 如果传 templateImage，请确保模板图与商品类目、版式方向一致。
- 提交任务时扣 50 积分；如果任务提交后执行失败，会按任务记录退还。
- 详情图完成时间通常长于单张图片生成，建议轮询间隔不低于 20 秒。
- 单次最多生成 100 个子任务；当前提交接口每次创建 1 个一键详情页任务。
- 达到服务端并发提交上限时会进入等待队列；等待超时或队列满时返回 429，请稍后重试。