agentCLAWHUBUnverified

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

OpenClaw

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
  1. Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
  2. 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 a
Github ReposUpdated 2d agoRank 70

AionUi

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!

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

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

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

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.

Sponsored

Ads related to Generate product photos for ecommerce and adjacent AI workflows.