CLI for AI Agents

One command.
Professional product photos.

Import any product from a URL, generate studio-quality marketing photos with AI, and download them optimized for Shopify, Instagram, or any platform. Works with Claude Code, Cursor, and any AI agent.

Quick Start

# Login with your Sintetica account
sintetica login --email you@company.com --password yourpassword

# Import a product and generate photos — one command
sintetica pipeline \
  --url "https://allbirds.com/products/mens-tree-runners" \
  --style lifestyle \
  --preset shopify \
  --out ./product-photos/

One click setup

Using Claude Code?

Copy this prompt and paste it into Claude Code. It will install the CLI, authenticate, and be ready to generate product photos for you.

Preview what gets copied

Install and set up the Sintetica CLI for AI product photography.

1. Install globally:
   npm install -g sintetica-cli

2. Login with my credentials (ask me for email/password or API key):
   sintetica login --email MY_EMAIL --password MY_PASSWORD

3. Then I can ask you to:
   - Import products from any URL: sintetica products import --url "https://..."
   - Generate photos: sintetica generate --product <id> --style minimal --wait
   - Download optimized: sintetica assets download <id> --preset shopify
   - Full pipeline: sintetica pipeline --url "https://..." --preset shopify --out ./photos/
   - Check credits: sintetica credits
   - Buy credits: sintetica topup --package credits_50

All output is JSON. Available styles: minimal, lifestyle, studio, editorial, flat_lay, nature.
Available presets: shopify, instagram, facebook, web, email, thumbnail.

How It Works

Import Product

Give it any product URL. Sintetica scrapes the name, images, and description automatically.

sintetica products import --url "https://..."

Generate Photos

Choose a style, format, and count. AI generates studio-quality product photography.

sintetica generate --product <id> --wait

Download Optimized

Download compressed for Shopify (500KB), Instagram, or any platform.

sintetica assets download <id> --preset shopify

Claude Code Integration

Setup with Claude Code

Claude Code can drive the entire Sintetica pipeline. Here's how to set it up.

Install the CLI

# Install globally from npm
npm install -g sintetica-cli

# Or run without installing
npx sintetica-cli --help

Authenticate

# Login with email/password — auto-generates and stores an API key
sintetica login --email you@company.com --password yourpassword

# Or if you already have an API key
sintetica login --key sk_live_...

# Config is stored at ~/.sintetica/config.json

Tell Claude Code to use it

Just ask Claude Code naturally. It will read the command outputs (all JSON) and chain the steps.

Prompt Examples

"Import this product from https://allbirds.com/products/mens-tree-runners
and generate 4 lifestyle photos optimized for Shopify"

"Check my Sintetica credit balance"

"Generate product photos for all my products in minimal style"

"Run the sintetica pipeline for this URL and download to ./photos/"

"Import this supplement bottle and generate Instagram-ready photos"

Command Reference

Authentication

sintetica login --email <email> --password <pass>Login with credentials, auto-generates API key

sintetica login --key sk_live_...Login with existing API key

sintetica login --base-url http://localhost:3000Use a custom server URL (for local dev)

Credits & Billing

sintetica creditsCheck current credit balance and tier

sintetica topup --listList available credit packages with prices

sintetica topup --package credits_150Get a Stripe checkout link to buy 150 credits ($99)

Products

sintetica products listList all products

sintetica products create --name "X" --image-url "https://..."Create product from an image URL

sintetica products import --url "https://shopify.com/product"Import from any e-commerce URL (scrapes name, image, description)

Generate

sintetica generate --product <id> --waitGenerate photos and wait for completion

sintetica generate --product <id> --style lifestyle --format instagram_story --count 4Full options: style, format, count

sintetica generate status --job <id>Check generation status

sintetica generate status --job <id> --waitWait for a specific job to complete

Assets

sintetica assets list --product <id>List assets for a product

sintetica assets download <id>Download original asset

sintetica assets download <id> --preset shopify --out photo.jpgDownload optimized for Shopify (2048px, ~500KB)

Pipeline (End-to-End)

One command that does everything: import → generate → wait → download.

sintetica pipeline \
  --url "https://allbirds.com/products/mens-tree-runners" \
  --style minimal \
  --format product_hero \
  --count 4 \
  --preset shopify \
  --out ./marketing-assets/

Styles & Formats

Photo Styles

minimalWhite background, soft shadows, clean

lifestyleNatural environment, warm lighting

studioDramatic shadows, gradient background

editorialMagazine-quality, artistic composition

flat_layOverhead view, organized layout

natureOutdoor setting, organic textures

Image Formats

instagram_square1080×1080 (1:1)

instagram_story1080×1920 (9:16)

facebook_post1200×630 (16:9)

tiktok1080×1920 (9:16)

product_hero1200×1200 (1:1)

Download Presets

shopify2048px, ~500KB JPEG

instagram1080px, ~1MB JPEG

facebook1200px, ~1MB JPEG

web1920px, ~300KB WebP

email600px, ~200KB JPEG

thumbnail400px, ~100KB JPEG

Product Categories

beautySkincare, makeup, fragrances

wellnessSupplements, vitamins, health

pharmaOTC medicine, medical devices

apparelClothing, shirts, dresses

footwearSneakers, boots, sandals

food_beveragePackaged foods, drinks

electronicsPhones, headphones, gadgets

API Reference

All endpoints accept Authorization: Bearer sk_live_... header. Responses are JSON.

Method	Endpoint	Description
POST	/api/cli/auth	Email/password → API key
GET	/api/cli/credits	Credit balance
GET	/api/cli/products	List products
POST	/api/cli/products	Create product
POST	/api/cli/products/import	Import from URL
POST	/api/cli/generate	Start photo generation
GET	/api/cli/generate/status	Poll job status
GET	/api/cli/assets	List assets
POST	/api/assets/optimize	Download optimized asset
GET	/api/cli/topup	List credit packages
POST	/api/cli/topup	Get Stripe checkout URL

Ready to automate your product photography?

Get Started

One command.Professional product photos.