支持 1-10 张参考图，适合商品换景、风格延展、营销素材生成。
提交任务
提交图片生成任务。适用于单商品换背景、营销图生成、风格延展等场景。
POST/api/third-party/genImage/generate
请求头
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| X-API-Token | string | 是 | 平台提供的调用凭证，用于识别当前账号或租户。 |
| Content-Type | string | 是 | 提交任务时固定使用 application/json。 |
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| prompt | string | 是 | 图片生成提示词，建议写清主体保留、背景、风格和用途。 |
| images | string[] | 是 | 参考图 URL 列表，支持 1-10 张。 |
| resolution | string | 否 | 输出分辨率，可传 1k、2k、4k。 |
| aspectRatio | string | 否 | 输出比例，如 1:1、4:3、16:9、auto。 |
请求示例
bash
curl -X POST "https://yunfanzhilian.com/api/third-party/genImage/generate" \
-H "X-API-Token: your_token" \
-H "Content-Type: application/json" \
-d '{
"prompt": "保留产品主体与瓶身文字，生成干净明亮的电商主图，背景简洁，突出高级感",
"images": [
"https://your-cdn.com/product-front.jpg",
"https://your-cdn.com/product-side.jpg"
],
"resolution": "1k",
"aspectRatio": "4:3"
}'响应字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 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": "67f0c1d6f4a0d2b4d1d0c001",
"status": "pending",
"estimatedTime": "30-90秒",
"images": [
"https://your-cdn.com/product-front.jpg",
"https://your-cdn.com/product-side.jpg"
],
"resolution": "1k",
"aspectRatio": "4:3"
},
"timestamp": "2026-03-31T09:30:00.000Z"
}注意事项
- 参考图建议使用可公网访问的 HTTPS URL。
- 提交接口只负责创建任务，生成结果请通过获取结果接口查询。
- 单次最多生成 100 个子任务；当前提交接口每次创建 1 个图片生成任务。
- 达到服务端并发提交上限时会进入等待队列；等待超时或队列满时返回 429，请稍后重试。