Generate product photos for ecommerce
Generate professional AI product photos using ProductAI.photo service. Use when users need to create, enhance, or transform product images for e-commerce, ma... Skill: Generate product photos for ecommerce Owner: shapes-2 Summary: Generate professional AI product photos using ProductAI.photo service. Use when users need to create, enhance, or transform product images for e-commerce, ma... Tags: latest:1.0.1 Version history: v1.0.1 | 2026-02-24T13:03:31.529Z | user • Updated API documentation with all the official endpoints from your file • Added new models: kontext-max • Doc
Rank
62
Safety
84
Downloads
1.1k
Updated
Oct 11, 2026
Version
1.0.1
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 1.1K downloadsadoption · observed Oct 11, 2026
- Latest release
- 1.0.1release · observed Feb 24, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s1786y733v1na5gqa9cw5sgq5d8a5qg4:productai-skill- Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-shapes-2-productai-skill/snapshot"
Documentation
CLAWHUB
126,833 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
--- name: productai description: Generate professional AI product photos using ProductAI.photo service. Use when users need to create, enhance, or transform product images for e-commerce, marketing, catalogs, or campaigns. Supports background replacement, product placement, scene generation, adaptive templates, and video ads. Use for tasks involving product photography, lifestyle shots, mockups, or marketing visuals. --- # ProductAI Integration ProductAI.photo is an AI-powered service that generates professional product photos from existing images. It enables e-commerce businesses, marketers, and designers to create studio-quality product photography without hiring photographers. ## Quick Start **1. Get Your API Key** Visit [ProductAI Studio](https://www.productai.photo) → **API Access** → Copy your API key **2. Run Setup** ```bash cd ~/.openclaw/workspace/productai scripts/setup.py # Paste your API key when prompted ``` **3. Generate Images** ```bash # Generate product photo with custom background scripts/generate_photo.py \ --image https://example.com/product.jpg \ --prompt "modern living room with natural lighting" \ --output result.png # Use multiple reference images (nanobanana/seedream support 2 images) scripts/generate_photo.py \ --image https://example.com/product1.jpg https://example.com/product2.jpg \ --prompt "Put the first image on top of the second image" \ --output result.png # High quality with Nano Banana Pro scripts/generate_photo.py \ --image https://example.com/product.jpg \ --prompt "white studio background" \ --model nanobananapro \ --output hq.png # Upscale an image (20 tokens) scripts/upscale_image.py \ --image https://example.com/photo.jpg \ --output upscaled.png ``` ## Core Capabilities **Photo Generation (`/api/generate`)** - Background replacement with AI-generated scenes - Product placement in realistic environments - Multi-image compositing (up to 2 reference images with certain models) - Custom prompts for full creative control **Image Upscaling (`/api/upscale`)** - Professional AI upscaling (Magnific Precision Upscale) - Preserves image details without distortion - 20 tokens per upscale **Models Available** - **gpt-low** — GPT Low Quality (2 tokens) - **gpt-medium** — GPT Medium Quality (3 tokens) - **gpt-high** — GPT High Quality (8 tokens) - **kontext-pro** — Kontext Pro (3 tokens) - **nanobanana** — Nano Banana (3 tokens) — **DEFAULT** - **nanobananapro** — Nano Banana Pro (8 tokens) - **seedream** — Seedream (3 tokens) **Multi-Image Support:** `nanobanana`, `nanobananapro`, and `seedream` support up to 2 reference images for advanced compositing. ## Configuration ### API Setup **Step 1: Get Your API Key** 1. Visit [ProductAI Studio](https://www.productai.photo) 2. Navigate to **API Access** section 3. Click **Generate API Key** or copy existing key **Step 2: Run Setup Script** ```bash cd ~/.openclaw/workspace/productai scripts/setup.py ``` This will interactively c
README.md
# ProductAI Integration for OpenClaw Generate professional AI product photos directly from OpenClaw using the ProductAI.photo API. ## What is ProductAI? ProductAI.photo is an AI-powered service that transforms product images with: - Background replacement and scene generation - Multi-image compositing - Professional upscaling - Multiple AI models for different quality levels Perfect for e-commerce, marketing, and content creation. ## Quick Links - **[ProductAI Website](https://www.productai.photo)** — Sign up & get API key - **[Quick Start Guide](QUICKSTART.md)** — Get running in 5 minutes - **[Setup Guide](SETUP-GUIDE.md)** — Detailed setup instructions & FAQ - **[Skill Documentation](SKILL.md)** — Full feature reference - **[API Reference](references/API.md)** — Complete API documentation ## Installation ### 1. Get Your API Key Visit [ProductAI Studio](https://www.productai.photo) → **API Access** → Copy your key ### 2. Run Setup ```bash cd ~/.openclaw/workspace/productai ./scripts/setup.py ``` Paste your API key when prompted. That's it! ### 3. Generate Images ```bash ./scripts/generate_photo.py \ --image "https://example.com/product.jpg" \ --prompt "white studio background" \ --output result.png ``` ## Available Scripts | Script | Purpose | |--------|---------| | `setup.py` | Configure API credentials | | `generate_photo.py` | Generate product photos | | `upscale_image.py` | Upscale images (20 tokens) | | `batch_generate.py` | Batch process multiple images | ## Common Use Cases ### Clean Product Backgrounds ```bash ./scripts/generate_photo.py \ --image "https://example.com/messy.jpg" \ --prompt "pure white background" \ --output clean.png ``` ### Lifestyle Photography ```bash ./scripts/generate_photo.py \ --image "https://example.com/watch.jpg" \ --prompt "wrist wearing watch, business setting" \ --output lifestyle.png ``` ### Multi-Image Compositing ```bash ./scripts/generate_photo.py \ --image "url1" "url2" \ --prompt "Combine both products" \ --model nanobanana \ --output combo.png ``` ### High Quality (Nano Banana Pro) ```bash ./scripts/generate_photo.py \ --image "https://example.com/product.jpg" \ --prompt "luxury marble countertop" \ --model nanobananapro \ --output premium.png ``` ## Models & Pricing | Model | Cost | Quality | |-------|------|---------| | `gpt-low` | 2 tokens | Low | | `gpt-medium` | 3 tokens | Medium | | `nanobanana` | 3 tokens | **Recommended** | | `kontext-pro` | 3 tokens | Good | | `seedream` | 3 tokens | Creative | | `gpt-high` | 8 tokens | High | | `nanobananapro` | 8 tokens | Premium | | **Upscale** | 20 tokens | — | **Multi-image support:** `nanobanana`, `nanobananapro`, `seedream` (max 2 images) ## Documentation - **New users:** Start with [QUICKSTART.md](QUICKSTART.md) - **Setup help:** See [SETUP-GUIDE.md](SETUP-GUIDE.md) - **Feature reference:** Read [SKILL.md](SKILL.md) - **API details:** Check [API.md](references/API.md) - **Security:** See [SEC
_meta.json
{
"ownerId": "kn747nct6wegm6yhndknwfj27s81q02v",
"slug": "productai-skill",
"version": "1.0.1",
"publishedAt": 1771938211529
}references/API.md
# ProductAI API Reference Complete documentation for ProductAI.photo public API endpoints. ## Base URL ``` https://api.productai.photo/v1 ``` ## Authentication All API requests require authentication via the `x-api-key` header: ```bash curl -H "x-api-key: YOUR_API_KEY" https://api.productai.photo/v1/api/generate ``` **Rate Limiting:** 15 requests per minute per IP address. --- ## `/api/generate` — Generate AI Product Photos Generate an AI-edited image from one or more input images with a text prompt. ### Endpoint ``` POST /api/generate ``` ### Request Body | Field | Type | Required | Description | | --------------- | ---------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `image_url` | `string` or `string[]` | Yes | URL(s) of input image(s). Maximum 2 images. | | `prompt` | `string` | Yes | Text prompt describing the desired edit/generation. | | `model` | `string` | Yes | One of: `gpt-low`, `gpt-medium`, `gpt-high`, `kontext-pro`, `kontext-max`, `nanobanana`, `nanobananapro`, `seedream` | | `output_format` | `string` | No | `"png"` (default) or `"jpg"` / `"jpeg"` | | `aspect_ratio` | `string` | No | `"SQUARE"`, `"LANDSCAPE"`, `"PORTRAIT"`. For `nanobanana`/`nanobananapro` also supports: `"LANDSCAPE_4_3"`, `"LANDSCAPE_5_4"`, `"SQUARE_1_1"`, `"PORTRAIT_4_5"`, `"PORTRAIT_3_4"`, or direct ratios like `"4:3"`, `"9:16"`, etc. | | `resolution` | `string` | No | For `nanobanana`/`nanobananapro` only: `"1K"`, `"2K"` (default), or `"4K"` | ### Models & Pricing | Model | Credits | Engine | | -------------- | ------- | ------------- | | `gpt-low` | 2 | GPT (Lambda) | | `gpt-medium` | 3 | GPT (Lambda) | | `gpt-high` | 8 | GPT (Lambda) | | `kontext-pro` | 2 | FAL | | `kontext-max` | 3 | FAL | | `nanobanana` | 3 | FAL | | `nanobananapro`| 8 | FAL | | `seedream`
references/INTEGRATION_GUIDE.md
# ProductAI Integration Guide
Complete guide for integrating ProductAI into your applications, workflows, and AI agents.
## Quick Start (5 minutes)
### 1. Install the Skill
```bash
# If skill is packaged as .skill file
openclaw skills install productai.skill
# Or clone directly
git clone https://github.com/your-org/productai-skill ~/.openclaw/workspace/productai
```
### 2. Configure API Credentials
```bash
cd ~/.openclaw/workspace/productai
python3 scripts/setup.py
```
Or manually create `config.json`:
```json
{
"api_key": "your-api-key-here",
"api_endpoint": "https://api.productai.photo/v1",
"default_model": "nano-banana-2",
"default_resolution": "1024x1024",
"plan": "standard"
}
```
### 3. Test It
```bash
# Generate your first photo
scripts/generate_photo.py \
--image product.jpg \
--prompt "white studio background with soft shadows" \
--output result.png
```
**Done!** You now have ProductAI integrated.
## Integration Patterns
### Pattern 1: Command-Line Scripts
Best for: Manual workflows, batch jobs, cron tasks
```bash
# Single photo generation
scripts/generate_photo.py --image product.jpg --prompt "modern living room" --output result.png
# Background replacement
scripts/generate_photo.py --image product.jpg --background-replace --output clean.png
# Batch processing
scripts/batch_generate.py \
--input-dir ./products \
--output-dir ./processed \
--template "white background with subtle shadows"
```
### Pattern 2: Python Library
Best for: Python applications, Jupyter notebooks, automation scripts
```python
from productai_client import create_client
# Initialize client
client = create_client()
# Generate photo
result = client.generate(
image='product.jpg',
prompt='modern living room with natural lighting'
)
# Download result
client.download_result(result['image_url'], 'output.png')
print(f"Credits used: {result['credits_used']}")
print(f"Processing time: {result['processing_time_ms']}ms")
```
### Pattern 3: AI Agent Integration
Best for: OpenClaw agents, LangChain, AutoGPT, other AI systems
**OpenClaw Integration:**
The skill is auto-loaded when OpenClaw detects product photo tasks. Just ask:
> "Generate a professional product photo of this bottle in a modern kitchen setting"
**Custom Agent Integration:**
```python
import subprocess
import json
def generate_product_photo(image_path: str, prompt: str) -> dict:
"""Call ProductAI from any AI agent."""
result = subprocess.run(
[
'python3',
'/path/to/productai/scripts/generate_photo.py',
'--image', image_path,
'--prompt', prompt,
'--output', 'result.png'
],
capture_output=True,
text=True
)
return json.loads(result.stdout)
# Use in your agent
result = generate_product_photo('product.jpg', 'white background')
print(f"Generated: {result['image_url']}")
```
### Pattern 4: REST API Wrapper
Best for: Microservices, web apps, team aAionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/shapes-2/skills/productai-skill",
"sourceUrl": "https://clawhub.ai/shapes-2/skills/productai-skill",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T11:56:59.186Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-shapes-2-productai-skill/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-shapes-2-productai-skill/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T11:56:59.186Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.1K downloads",
"href": "https://clawhub.ai/shapes-2/productai-skill",
"sourceUrl": "https://clawhub.ai/shapes-2/productai-skill",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T11:56:59.186Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.1",
"href": "https://clawhub.ai/shapes-2/productai-skill",
"sourceUrl": "https://clawhub.ai/shapes-2/productai-skill",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-02-24T13:03:31.529Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-shapes-2-productai-skill/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-shapes-2-productai-skill/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.1",
"description": "• Updated API documentation with all the official endpoints from your file • Added new models: kontext-max • Documented aspect_ratio parameter with extended ratios for nanobanana models • Added resolution parameter (1K/2K/4K) • Complete error handling documentation • Created CHANGELOG.md to track versions",
"href": "https://clawhub.ai/shapes-2/productai-skill",
"sourceUrl": "https://clawhub.ai/shapes-2/productai-skill",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-02-24T13:03:31.529Z",
"isPublic": true
}
]
}Record generated Oct 11, 2026.
