{
  "schemaVersion": "1.0",
  "item": {
    "slug": "productai-skill",
    "name": "Generate product photos for ecommerce",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/Shapes/productai-skill",
    "canonicalUrl": "https://clawhub.ai/Shapes/productai-skill",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/productai-skill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=productai-skill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "CHANGELOG.md",
      "QUICKSTART.md",
      "SETUP-GUIDE.md",
      "README.md",
      "config.example.json",
      "package.json"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/productai-skill"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/productai-skill",
    "agentPageUrl": "https://openagent3.xyz/skills/productai-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/productai-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/productai-skill/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "ProductAI Integration",
        "body": "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."
      },
      {
        "title": "Quick Start",
        "body": "1. Get Your API Key\n\nVisit ProductAI Studio → API Access → Copy your API key\n\n2. Run Setup\n\ncd ~/.openclaw/workspace/productai\nscripts/setup.py\n# Paste your API key when prompted\n\n3. Generate Images\n\n# Generate product photo with custom background\nscripts/generate_photo.py \\\n  --image https://example.com/product.jpg \\\n  --prompt \"modern living room with natural lighting\" \\\n  --output result.png\n\n# Use multiple reference images (nanobanana/seedream support 2 images)\nscripts/generate_photo.py \\\n  --image https://example.com/product1.jpg https://example.com/product2.jpg \\\n  --prompt \"Put the first image on top of the second image\" \\\n  --output result.png\n\n# High quality with Nano Banana Pro\nscripts/generate_photo.py \\\n  --image https://example.com/product.jpg \\\n  --prompt \"white studio background\" \\\n  --model nanobananapro \\\n  --output hq.png\n\n# Upscale an image (20 tokens)\nscripts/upscale_image.py \\\n  --image https://example.com/photo.jpg \\\n  --output upscaled.png"
      },
      {
        "title": "Core Capabilities",
        "body": "Photo Generation (/api/generate)\n\nBackground replacement with AI-generated scenes\nProduct placement in realistic environments\nMulti-image compositing (up to 2 reference images with certain models)\nCustom prompts for full creative control\n\nImage Upscaling (/api/upscale)\n\nProfessional AI upscaling (Magnific Precision Upscale)\nPreserves image details without distortion\n20 tokens per upscale\n\nModels Available\n\ngpt-low — GPT Low Quality (2 tokens)\ngpt-medium — GPT Medium Quality (3 tokens)\ngpt-high — GPT High Quality (8 tokens)\nkontext-pro — Kontext Pro (3 tokens)\nnanobanana — Nano Banana (3 tokens) — DEFAULT\nnanobananapro — Nano Banana Pro (8 tokens)\nseedream — Seedream (3 tokens)\n\nMulti-Image Support:\nnanobanana, nanobananapro, and seedream support up to 2 reference images for advanced compositing."
      },
      {
        "title": "API Setup",
        "body": "Step 1: Get Your API Key\n\nVisit ProductAI Studio\nNavigate to API Access section\nClick Generate API Key or copy existing key\n\nStep 2: Run Setup Script\n\ncd ~/.openclaw/workspace/productai\nscripts/setup.py\n\nThis will interactively create config.json with your credentials:\n\n{\n  \"api_key\": \"your-api-key-here\",\n  \"api_endpoint\": \"https://api.productai.photo/v1\",\n  \"default_model\": \"nanobanana\",\n  \"default_resolution\": \"1024x1024\",\n  \"plan\": \"standard\"\n}\n\nThe config file is automatically secured with 600 permissions."
      },
      {
        "title": "Installation",
        "body": "The integration scripts require Python 3.7+ with these dependencies:\n\npip install requests pillow\n\nAll dependencies are handled automatically by the scripts."
      },
      {
        "title": "E-commerce Product Photos",
        "body": "Generate clean product shots for online stores:\n\nscripts/generate_photo.py \\\n  --image https://example.com/raw-product.jpg \\\n  --prompt \"white studio background with soft shadows\" \\\n  --output store-listing.png"
      },
      {
        "title": "Marketing Campaign Visuals",
        "body": "Create lifestyle shots for advertising:\n\nscripts/generate_photo.py \\\n  --image https://example.com/bottle.jpg \\\n  --prompt \"outdoor picnic scene with blanket and basket, golden hour lighting\" \\\n  --output campaign-hero.png \\\n  --model kontext-pro"
      },
      {
        "title": "Multi-Image Compositing",
        "body": "Combine multiple products into one scene:\n\nscripts/generate_photo.py \\\n  --image https://example.com/product1.jpg https://example.com/product2.jpg \\\n  --prompt \"Place the lipstick on top of the cosmetics box\" \\\n  --model nanobanana \\\n  --output composite.png"
      },
      {
        "title": "High-Quality Output",
        "body": "Use Nano Banana Pro for premium results:\n\nscripts/generate_photo.py \\\n  --image https://example.com/product.jpg \\\n  --prompt \"luxury marble countertop setting with morning light\" \\\n  --model nanobananapro \\\n  --output premium.png"
      },
      {
        "title": "Image Upscaling",
        "body": "Upscale images for print or high-res displays:\n\nscripts/upscale_image.py \\\n  --image https://example.com/product.jpg \\\n  --output upscaled.png"
      },
      {
        "title": "Async Workflow (No Wait)",
        "body": "Start generation and check later:\n\n# Start job (prints job ID)\nscripts/generate_photo.py \\\n  --image https://example.com/product.jpg \\\n  --prompt \"studio background\" \\\n  --no-wait\n\n# Output: Job created: 12345\n\n# Later, resume and download\nscripts/generate_photo.py \\\n  --job-id 12345 \\\n  --output result.png"
      },
      {
        "title": "API Reference",
        "body": "See API.md for complete endpoint documentation, request/response formats, and authentication details."
      },
      {
        "title": "Pricing & Token Costs",
        "body": "ProductAI uses a token-based pricing system:\n\nOperationToken CostGPT Low Quality Generation2 tokensGPT Medium Quality Generation3 tokensGPT High Quality Generation8 tokensKontext Pro3 tokensNano Banana Pro8 tokensNano Banana3 tokensSeedream3 tokensMagnific Precision Upscale20 tokens\n\nSubscription Plans:\n\nVisit ProductAI.photo for current plans and token packages.\n\nRate Limits:\n\n15 requests per minute\nDaily limits based on subscription plan\n\nNote: Tokens are deducted when each operation starts (not on completion)."
      },
      {
        "title": "Troubleshooting",
        "body": "API Key Issues\n\nVerify config.json exists: cat ~/.openclaw/workspace/productai/config.json\nCheck API key in ProductAI Studio → API Access\nRegenerate key if needed\n\nOUT_OF_TOKENS Error\n\nCheck your token balance in ProductAI Studio\nPurchase more tokens or upgrade plan\nRemember: tokens are deducted when jobs start, not on completion\n\nRate Limit (429)\n\nMaximum 15 requests per minute\nWait before retrying\nUse --no-wait for batch jobs and check status later\n\nJob Failed (ERROR status)\n\nCheck image URL is accessible and under 10MB\nVerify image format (PNG, JPG, or WebP only)\nCheck prompt length and content\nTry a different model\n\nMulti-Image Not Working\n\nOnly nanobanana, nanobananapro, and seedream support multiple images\nMaximum 2 reference images\nUse array format: --image url1 url2"
      },
      {
        "title": "Support",
        "body": "Website: https://www.productai.photo\nDocumentation: See references/API.md\nContact: support@productai.photo (or team contact when available)"
      },
      {
        "title": "Advanced Topics",
        "body": "For detailed API specifications, authentication flows, webhook integration, and batch processing patterns, see API.md."
      }
    ],
    "body": "ProductAI Integration\n\nProductAI.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.\n\nQuick Start\n\n1. Get Your API Key\n\nVisit ProductAI Studio → API Access → Copy your API key\n\n2. Run Setup\n\ncd ~/.openclaw/workspace/productai\nscripts/setup.py\n# Paste your API key when prompted\n\n\n3. Generate Images\n\n# Generate product photo with custom background\nscripts/generate_photo.py \\\n  --image https://example.com/product.jpg \\\n  --prompt \"modern living room with natural lighting\" \\\n  --output result.png\n\n# Use multiple reference images (nanobanana/seedream support 2 images)\nscripts/generate_photo.py \\\n  --image https://example.com/product1.jpg https://example.com/product2.jpg \\\n  --prompt \"Put the first image on top of the second image\" \\\n  --output result.png\n\n# High quality with Nano Banana Pro\nscripts/generate_photo.py \\\n  --image https://example.com/product.jpg \\\n  --prompt \"white studio background\" \\\n  --model nanobananapro \\\n  --output hq.png\n\n# Upscale an image (20 tokens)\nscripts/upscale_image.py \\\n  --image https://example.com/photo.jpg \\\n  --output upscaled.png\n\nCore Capabilities\n\nPhoto Generation (/api/generate)\n\nBackground replacement with AI-generated scenes\nProduct placement in realistic environments\nMulti-image compositing (up to 2 reference images with certain models)\nCustom prompts for full creative control\n\nImage Upscaling (/api/upscale)\n\nProfessional AI upscaling (Magnific Precision Upscale)\nPreserves image details without distortion\n20 tokens per upscale\n\nModels Available\n\ngpt-low — GPT Low Quality (2 tokens)\ngpt-medium — GPT Medium Quality (3 tokens)\ngpt-high — GPT High Quality (8 tokens)\nkontext-pro — Kontext Pro (3 tokens)\nnanobanana — Nano Banana (3 tokens) — DEFAULT\nnanobananapro — Nano Banana Pro (8 tokens)\nseedream — Seedream (3 tokens)\n\nMulti-Image Support: nanobanana, nanobananapro, and seedream support up to 2 reference images for advanced compositing.\n\nConfiguration\nAPI Setup\n\nStep 1: Get Your API Key\n\nVisit ProductAI Studio\nNavigate to API Access section\nClick Generate API Key or copy existing key\n\nStep 2: Run Setup Script\n\ncd ~/.openclaw/workspace/productai\nscripts/setup.py\n\n\nThis will interactively create config.json with your credentials:\n\n{\n  \"api_key\": \"your-api-key-here\",\n  \"api_endpoint\": \"https://api.productai.photo/v1\",\n  \"default_model\": \"nanobanana\",\n  \"default_resolution\": \"1024x1024\",\n  \"plan\": \"standard\"\n}\n\n\nThe config file is automatically secured with 600 permissions.\n\nInstallation\n\nThe integration scripts require Python 3.7+ with these dependencies:\n\npip install requests pillow\n\n\nAll dependencies are handled automatically by the scripts.\n\nUsage Examples\nE-commerce Product Photos\n\nGenerate clean product shots for online stores:\n\nscripts/generate_photo.py \\\n  --image https://example.com/raw-product.jpg \\\n  --prompt \"white studio background with soft shadows\" \\\n  --output store-listing.png\n\nMarketing Campaign Visuals\n\nCreate lifestyle shots for advertising:\n\nscripts/generate_photo.py \\\n  --image https://example.com/bottle.jpg \\\n  --prompt \"outdoor picnic scene with blanket and basket, golden hour lighting\" \\\n  --output campaign-hero.png \\\n  --model kontext-pro\n\nMulti-Image Compositing\n\nCombine multiple products into one scene:\n\nscripts/generate_photo.py \\\n  --image https://example.com/product1.jpg https://example.com/product2.jpg \\\n  --prompt \"Place the lipstick on top of the cosmetics box\" \\\n  --model nanobanana \\\n  --output composite.png\n\nHigh-Quality Output\n\nUse Nano Banana Pro for premium results:\n\nscripts/generate_photo.py \\\n  --image https://example.com/product.jpg \\\n  --prompt \"luxury marble countertop setting with morning light\" \\\n  --model nanobananapro \\\n  --output premium.png\n\nImage Upscaling\n\nUpscale images for print or high-res displays:\n\nscripts/upscale_image.py \\\n  --image https://example.com/product.jpg \\\n  --output upscaled.png\n\nAsync Workflow (No Wait)\n\nStart generation and check later:\n\n# Start job (prints job ID)\nscripts/generate_photo.py \\\n  --image https://example.com/product.jpg \\\n  --prompt \"studio background\" \\\n  --no-wait\n\n# Output: Job created: 12345\n\n# Later, resume and download\nscripts/generate_photo.py \\\n  --job-id 12345 \\\n  --output result.png\n\nAPI Reference\n\nSee API.md for complete endpoint documentation, request/response formats, and authentication details.\n\nPricing & Token Costs\n\nProductAI uses a token-based pricing system:\n\nOperation\tToken Cost\nGPT Low Quality Generation\t2 tokens\nGPT Medium Quality Generation\t3 tokens\nGPT High Quality Generation\t8 tokens\nKontext Pro\t3 tokens\nNano Banana Pro\t8 tokens\nNano Banana\t3 tokens\nSeedream\t3 tokens\nMagnific Precision Upscale\t20 tokens\n\nSubscription Plans:\n\nVisit ProductAI.photo for current plans and token packages.\n\nRate Limits:\n\n15 requests per minute\nDaily limits based on subscription plan\n\nNote: Tokens are deducted when each operation starts (not on completion).\n\nTroubleshooting\n\nAPI Key Issues\n\nVerify config.json exists: cat ~/.openclaw/workspace/productai/config.json\nCheck API key in ProductAI Studio → API Access\nRegenerate key if needed\n\nOUT_OF_TOKENS Error\n\nCheck your token balance in ProductAI Studio\nPurchase more tokens or upgrade plan\nRemember: tokens are deducted when jobs start, not on completion\n\nRate Limit (429)\n\nMaximum 15 requests per minute\nWait before retrying\nUse --no-wait for batch jobs and check status later\n\nJob Failed (ERROR status)\n\nCheck image URL is accessible and under 10MB\nVerify image format (PNG, JPG, or WebP only)\nCheck prompt length and content\nTry a different model\n\nMulti-Image Not Working\n\nOnly nanobanana, nanobananapro, and seedream support multiple images\nMaximum 2 reference images\nUse array format: --image url1 url2\nSupport\nWebsite: https://www.productai.photo\nDocumentation: See references/API.md\nContact: support@productai.photo (or team contact when available)\nAdvanced Topics\n\nFor detailed API specifications, authentication flows, webhook integration, and batch processing patterns, see API.md."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/Shapes/productai-skill",
    "publisherUrl": "https://clawhub.ai/Shapes/productai-skill",
    "owner": "Shapes",
    "version": "1.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/productai-skill",
    "downloadUrl": "https://openagent3.xyz/downloads/productai-skill",
    "agentUrl": "https://openagent3.xyz/skills/productai-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/productai-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/productai-skill/agent.md"
  }
}