ProductAI 集成

ProductAI.photo 是一项由 AI 驱动的服务，可基于现有图像生成专业级产品照片。它帮助电商企业、营销人员和设计师无需聘请摄影师，即可制作影棚级水准的产品摄影图像。

快速入门

1. 获取您的 API 密钥

访问 ProductAI Studio → API 访问 → 复制您的 API 密钥

2. 运行初始化脚本

cd ~/.openclaw/workspace/productai
scripts/setup.py
# 提示时粘贴您的 API 密钥

3. 生成图像

# 使用自定义背景生成产品照片
scripts/generate_photo.py 
  --image https://example.com/product.jpg 
  --prompt "现代起居室，自然采光" 
  --output result.png

# 使用多张参考图像（nanobanana/seedream 支持 2 张图像）
scripts/generate_photo.py 
  --image https://example.com/product1.jpg https://example.com/product2.jpg 
  --prompt "将第一张图像置于第二张图像之上" 
  --output result.png

# 使用 Nano Banana Pro 生成高质量图像
scripts/generate_photo.py 
  --image https://example.com/product.jpg 
  --prompt "纯白影棚背景" 
  --model nanobananapro 
  --output hq.png

# 图像超分（20 tokens）
scripts/upscale_image.py 
  --image https://example.com/photo.jpg 
  --output upscaled.png

核心能力

图像生成（/api/generate）

• AI 生成场景的背景替换
• 产品在真实环境中的精准摆放
• 多图合成（部分模型最多支持 2 张参考图像）
• 支持自定义提示词，实现完整创意控制

图像超分（/api/upscale）

• 专业级 AI 超分（Magnific Precision Upscale）
• 保留图像细节，无失真
• 每次超分消耗 20 tokens

可用模型

• gpt-low — GPT 低质量（2 tokens）
• gpt-medium — GPT 中等质量（3 tokens）
• gpt-high — GPT 高质量（8 tokens）
• kontext-pro — Kontext Pro（3 tokens）
• nanobanana — Nano Banana（3 tokens）— 默认模型
• nanobananapro — Nano Banana Pro（8 tokens）
• seedream — Seedream（3 tokens）

多图支持：nanobanana、nanobananapro 和 seedream 支持最多 2 张参考图像，适用于高级图像合成任务。

配置

API 初始化

步骤 1：获取您的 API 密钥

1. 访问 ProductAI Studio
2. 进入 API 访问 页面
3. 点击 生成 API 密钥 或复制已有密钥

步骤 2：运行初始化脚本

cd ~/.openclaw/workspace/productai
scripts/setup.py

该脚本将交互式创建含凭据信息的 config.json 文件：

{
  "api_key": "your-api-key-here",
  "api_endpoint": "https://api.productai.photo/v1",
  "default_model": "nanobanana",
  "default_resolution": "1024x1024",
  "plan": "standard"
}

配置文件会自动设置为 600 权限以保障安全。

安装依赖

集成脚本需 Python 3.7+ 及以下依赖：

pip install requests pillow

所有依赖均由脚本自动处理。

使用示例

电商产品图

为线上商店生成简洁专业的产品图：

scripts/generate_photo.py 
  --image https://example.com/raw-product.jpg 
  --prompt "纯白影棚背景，柔和阴影" 
  --output store-listing.png

营销活动视觉素材

为广告制作生活方式类图像：

scripts/generate_photo.py 
  --image https://example.com/bottle.jpg 
  --prompt "户外野餐场景，含毛毯与竹篮，黄金时刻光线" 
  --output campaign-hero.png 
  --model kontext-pro

多图合成

将多个产品合成至同一场景中：

scripts/generate_photo.py 
  --image https://example.com/product1.jpg https://example.com/product2.jpg 
  --prompt "将口红置于化妆品盒顶部" 
  --model nanobanana 
  --output composite.png

高质量输出

使用 Nano Banana Pro 获取高端效果：

scripts/generate_photo.py 
  --image https://example.com/product.jpg 
  --prompt "奢华大理石台面，晨光氛围" 
  --model nanobananapro 
  --output premium.png

图像超分

提升图像分辨率，适配印刷或高分辨率显示设备：

scripts/upscale_image.py 
  --image https://example.com/product.jpg 
  --output upscaled.png

异步工作流（无需等待）

启动生成任务后稍后检查结果：

# 启动任务（打印任务 ID）
scripts/generate_photo.py 
  --image https://example.com/product.jpg 
  --prompt "影棚背景" 
  --no-wait

# 输出：任务已创建：12345

# 稍后恢复并下载结果
scripts/generate_photo.py 
  --job-id 12345 
  --output result.png

API 参考文档

详见 API.md，包含完整端点说明、请求/响应格式及认证细节。

定价与 Token 消耗

ProductAI 采用基于 Token 的计费体系：

订阅方案：

请访问 ProductAI.photo 查看当前订阅计划与 Token 套餐。

速率限制：

• 每分钟最多 15 次请求
• 日请求上限取决于所选订阅方案

注意：Token 在每次操作启动时扣除（而非完成时）。

故障排查

API 密钥问题

• 确认 config.json 文件存在：cat ~/.openclaw/workspace/productai/config.json
• 检查 ProductAI Studio → API 访问页面中的 API 密钥
• 如需，可重新生成密钥

OUT_OF_TOKENS 错误

• 在 ProductAI Studio 中查看您的 Token 余额
• 购买更多 Token 或升级订阅方案
• 注意：Token 在任务启动时扣除，而非完成时

速率限制（HTTP 429）

• 每分钟最多 15 次请求
• 请等待后再重试
• 批量任务建议使用 --no-wait 参数，稍后查询状态

任务失败（返回 ERROR 状态）

• 确认图像 URL 可访问且大小不超过 10MB
• 验证图像格式（仅支持 PNG、JPG 或 WebP）
• 检查提示词长度与内容是否合规
• 尝试切换其他模型

多图功能未生效

• 仅 nanobanana、nanobananapro 和 seedream 支持多图输入
• 最多支持 2 张参考图像
• 请使用数组格式：--image url1 url2

支持

• 官网：https://www.productai.photo
• 文档：参见 references/API.md
• 联系邮箱：support@productai.photo（或团队指定联系人，如有）

进阶主题

有关详细 API 规范、认证流程、Webhook 集成及批量处理模式，请参阅 API.md。