提交 A+ 图片生成任务
curl --request POST \
--url https://api.ch88.cn/v1/open/aplus/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"module_key": "core",
"target_size": "970x600",
"model": "gpt-image-2",
"product_brief": "一款滴管瓶装保湿精华液,面向日常补水保湿需求。",
"module_note": "突出清爽质地,不使用医疗或夸大功效表述。",
"platform": "Amazon",
"market": "US",
"language": "zh-CN",
"resolution": "1k",
"image_urls": [
"https://api.ch88.cn/v1/linggan/media/assets/generated%2Fopen-upload%2Fexample-front.png"
],
"plan_prompt": "以产品瓶身为中心,使用水感背景和简洁的信息分区。",
"negative_prompt": "不添加未经证实的认证、奖项或功效数据。",
"series_style_guide": "浅蓝与白色体系,柔和自然光,所有模块保持一致。"
}
'import requests
url = "https://api.ch88.cn/v1/open/aplus/generations"
payload = {
"module_key": "core",
"target_size": "970x600",
"model": "gpt-image-2",
"product_brief": "一款滴管瓶装保湿精华液,面向日常补水保湿需求。",
"module_note": "突出清爽质地,不使用医疗或夸大功效表述。",
"platform": "Amazon",
"market": "US",
"language": "zh-CN",
"resolution": "1k",
"image_urls": ["https://api.ch88.cn/v1/linggan/media/assets/generated%2Fopen-upload%2Fexample-front.png"],
"plan_prompt": "以产品瓶身为中心,使用水感背景和简洁的信息分区。",
"negative_prompt": "不添加未经证实的认证、奖项或功效数据。",
"series_style_guide": "浅蓝与白色体系,柔和自然光,所有模块保持一致。"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
module_key: 'core',
target_size: '970x600',
model: 'gpt-image-2',
product_brief: '一款滴管瓶装保湿精华液,面向日常补水保湿需求。',
module_note: '突出清爽质地,不使用医疗或夸大功效表述。',
platform: 'Amazon',
market: 'US',
language: 'zh-CN',
resolution: '1k',
image_urls: [
'https://api.ch88.cn/v1/linggan/media/assets/generated%2Fopen-upload%2Fexample-front.png'
],
plan_prompt: '以产品瓶身为中心,使用水感背景和简洁的信息分区。',
negative_prompt: '不添加未经证实的认证、奖项或功效数据。',
series_style_guide: '浅蓝与白色体系,柔和自然光,所有模块保持一致。'
})
};
fetch('https://api.ch88.cn/v1/open/aplus/generations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"code": 200,
"data": {
"status": "submitted",
"task_id": "task_01K4Y9A7B8C9D0E1F2G3H4J5K6"
},
"request_id": "req_550e8400-e29b-41d4-a716-446655440000"
}
{
"error": {
"code": 400,
"type": "invalid_request_error",
"message": "请至少提供 1 张产品图"
},
"request_id": "req_xxx"
}
{
"error": {
"code": 401,
"type": "authentication_error",
"message": "缺少 Public API Key"
},
"request_id": "req_xxx"
}
{
"error": {
"code": 403,
"type": "permission_error",
"message": "成员或组织已停用"
},
"request_id": "req_xxx"
}
{
"error": {
"code": 409,
"type": "conflict_error",
"message": "成员未分配有效上游密钥"
},
"request_id": "req_xxx"
}
{
"error": {
"code": 429,
"type": "rate_limit_error",
"message": "请求过于频繁,请稍后重试",
"retryable": true
},
"request_id": "req_xxx"
}
{
"error": {
"code": 502,
"type": "upstream_error",
"message": "上游服务暂时不可用,请稍后重试",
"retryable": true
},
"request_id": "req_xxx"
}
{
"error": {
"code": 503,
"type": "service_unavailable_error",
"message": "服务暂时不可用,请稍后重试",
"retryable": true
},
"request_id": "req_550e8400-e29b-41d4-a716-446655440000"
}
全部接口
提交 A+ 图片生成任务
为一个 A+ 模块提交图片生成任务。module_key 和 image_urls 必填;默认模型为 gpt-image-2,默认分辨率为 1k。
POST
https://api.ch88.cn
/
v1
/
open
/
aplus
/
generations
提交 A+ 图片生成任务
curl --request POST \
--url https://api.ch88.cn/v1/open/aplus/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"module_key": "core",
"target_size": "970x600",
"model": "gpt-image-2",
"product_brief": "一款滴管瓶装保湿精华液,面向日常补水保湿需求。",
"module_note": "突出清爽质地,不使用医疗或夸大功效表述。",
"platform": "Amazon",
"market": "US",
"language": "zh-CN",
"resolution": "1k",
"image_urls": [
"https://api.ch88.cn/v1/linggan/media/assets/generated%2Fopen-upload%2Fexample-front.png"
],
"plan_prompt": "以产品瓶身为中心,使用水感背景和简洁的信息分区。",
"negative_prompt": "不添加未经证实的认证、奖项或功效数据。",
"series_style_guide": "浅蓝与白色体系,柔和自然光,所有模块保持一致。"
}
'import requests
url = "https://api.ch88.cn/v1/open/aplus/generations"
payload = {
"module_key": "core",
"target_size": "970x600",
"model": "gpt-image-2",
"product_brief": "一款滴管瓶装保湿精华液,面向日常补水保湿需求。",
"module_note": "突出清爽质地,不使用医疗或夸大功效表述。",
"platform": "Amazon",
"market": "US",
"language": "zh-CN",
"resolution": "1k",
"image_urls": ["https://api.ch88.cn/v1/linggan/media/assets/generated%2Fopen-upload%2Fexample-front.png"],
"plan_prompt": "以产品瓶身为中心,使用水感背景和简洁的信息分区。",
"negative_prompt": "不添加未经证实的认证、奖项或功效数据。",
"series_style_guide": "浅蓝与白色体系,柔和自然光,所有模块保持一致。"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
module_key: 'core',
target_size: '970x600',
model: 'gpt-image-2',
product_brief: '一款滴管瓶装保湿精华液,面向日常补水保湿需求。',
module_note: '突出清爽质地,不使用医疗或夸大功效表述。',
platform: 'Amazon',
market: 'US',
language: 'zh-CN',
resolution: '1k',
image_urls: [
'https://api.ch88.cn/v1/linggan/media/assets/generated%2Fopen-upload%2Fexample-front.png'
],
plan_prompt: '以产品瓶身为中心,使用水感背景和简洁的信息分区。',
negative_prompt: '不添加未经证实的认证、奖项或功效数据。',
series_style_guide: '浅蓝与白色体系,柔和自然光,所有模块保持一致。'
})
};
fetch('https://api.ch88.cn/v1/open/aplus/generations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"code": 200,
"data": {
"status": "submitted",
"task_id": "task_01K4Y9A7B8C9D0E1F2G3H4J5K6"
},
"request_id": "req_550e8400-e29b-41d4-a716-446655440000"
}
{
"error": {
"code": 400,
"type": "invalid_request_error",
"message": "请至少提供 1 张产品图"
},
"request_id": "req_xxx"
}
{
"error": {
"code": 401,
"type": "authentication_error",
"message": "缺少 Public API Key"
},
"request_id": "req_xxx"
}
{
"error": {
"code": 403,
"type": "permission_error",
"message": "成员或组织已停用"
},
"request_id": "req_xxx"
}
{
"error": {
"code": 409,
"type": "conflict_error",
"message": "成员未分配有效上游密钥"
},
"request_id": "req_xxx"
}
{
"error": {
"code": 429,
"type": "rate_limit_error",
"message": "请求过于频繁,请稍后重试",
"retryable": true
},
"request_id": "req_xxx"
}
{
"error": {
"code": 502,
"type": "upstream_error",
"message": "上游服务暂时不可用,请稍后重试",
"retryable": true
},
"request_id": "req_xxx"
}
{
"error": {
"code": 503,
"type": "service_unavailable_error",
"message": "服务暂时不可用,请稍后重试",
"retryable": true
},
"request_id": "req_550e8400-e29b-41d4-a716-446655440000"
}
{
"code": 200,
"data": {
"status": "submitted",
"task_id": "task_01K4Y9A7B8C9D0E1F2G3H4J5K6"
},
"request_id": "req_550e8400-e29b-41d4-a716-446655440000"
}
{
"error": {
"code": 400,
"type": "invalid_request_error",
"message": "请至少提供 1 张产品图"
},
"request_id": "req_xxx"
}
{
"error": {
"code": 401,
"type": "authentication_error",
"message": "缺少 Public API Key"
},
"request_id": "req_xxx"
}
{
"error": {
"code": 403,
"type": "permission_error",
"message": "成员或组织已停用"
},
"request_id": "req_xxx"
}
{
"error": {
"code": 409,
"type": "conflict_error",
"message": "成员未分配有效上游密钥"
},
"request_id": "req_xxx"
}
{
"error": {
"code": 429,
"type": "rate_limit_error",
"message": "请求过于频繁,请稍后重试",
"retryable": true
},
"request_id": "req_xxx"
}
{
"error": {
"code": 502,
"type": "upstream_error",
"message": "上游服务暂时不可用,请稍后重试",
"retryable": true
},
"request_id": "req_xxx"
}
{
"error": {
"code": 503,
"type": "service_unavailable_error",
"message": "服务暂时不可用,请稍后重试",
"retryable": true
},
"request_id": "req_550e8400-e29b-41d4-a716-446655440000"
}
授权
成员级 Public API Key。请填写完整密钥,Mintlify Playground 会自动以 Authorization: Bearer <PUBLIC_API_KEY> 发送。完整明文只在管理后台创建成功时显示一次。
请求体
application/json
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 商品图 URL。gpt-image-2 最多 15 张,三个 Banana 模型最多 14 张。
Required array length:
1 - 15 elementsA+ 最终交付版式尺寸。省略时使用所选模块的默认尺寸。
可用选项:
1464x600, 970x600, 970x300, 600x450, 463x625, 220x220, 150x300 可选的模型原生生成比例。通常无需填写;如果填写,必须与 target_size 和 model 的平台映射一致。
示例:
"3:2"
A+ 生图模型。不同模型支持的图片数量和分辨率不同。
可用选项:
gpt-image-2, nano-banana-2-lite, nano-banana-2, nano-banana-pro 商品简报。未传入 plan_prompt 时强烈建议提供。
Maximum string length:
2000当前模块的补充要求。
目标电商平台。
目标市场或国家。
图片文案语言;使用 no-text 可要求纯视觉画面。
输出分辨率。0.5k 仅部分模型支持。
可用选项:
0.5k, 1k, 2k, 4k A+ 策划接口返回的 recommended_prompt,或客户编辑后的模块提示词。
不希望图片中出现的内容和表现方式。
A+ 策划接口返回的 global_style,用于保持多模块视觉一致。
响应
查询任务结果
任务提交成功后返回 data.task_id。请保存该任务编号,并通过 GET /v1/open/tasks/{task_id} 轮询任务状态,详见查询生图任务。

