weshop-cli

One command. Studio-quality images and videos.

weshop-cli turns WeShop AI into a command-line tool — virtual try-on, model swap, background replace, pose change, canvas expand, AI video generation, video enhancement, and much more. Built for developers and AI agents who want to generate production-ready fashion, product, and creative media without touching a browser.

# Virtual try-on: put a garment onto a model reference
weshop virtualtryon --image ./garment.png --model-image ./model-photo.png --gen-version weshopPro --prompt-mode auto --aspect-ratio 2:3

# Generate a cinematic video from an image using Kling
weshop kling --image ./scene.png --prompt 'Camera slowly pans across a misty forest' --model Kling_3_0 --duration 8s

# Remove background and replace with white
weshop removebg --image ./product.png --mask-type autoSubjectSegment --bg-hex '#ffffff'

Why

• One command = one task. No curl, no JSON, no polling loops.
• Agent-friendly. Structured [key]: value output that any LLM agent can parse. No colors, no spinners, no noise.
• Local files just work. Pass a local path to --image and it auto-uploads. Same file won't upload twice (cached by path + size + mtime).
• Blocking or async. Waits for results by default. Add --no-wait to get the execution ID and poll later with weshop status.

Quick start

Get your API key at open.weshop.ai/authorization/apikey, then:

npm install -g weshop-cli
export WESHOP_API_KEY=<your-key>
weshop --help

For developers

git clone https://github.com/weshopai/weshop-cli.git
cd weshop-cli
npm install
export WESHOP_API_KEY=<your-key>
npx tsx src/index.ts --help

Commands

Run weshop <command> --help to see each command's full parameters, enum values, and examples.

Image Agents

| Command | What it does | |---|---| | 2d-to-3d-image-converter | AI 2D to 3D image converter — transform a flat 2D image into a 3D rendered version | | ai-3d-rendering | AI 3D rendering — transform a photo into a Blender-style 3D model viewport screenshot | | ai-action-figure-generators | AI action figure generator — turn a photo or character into a collectible action figure display | | ai-aging | AI age progression — transform a portrait to show how the person will look older | | ai-babe | AI babe generator — generate photorealistic attractive images from a person photo | | ai-bikini-model | AI bikini model — transform a person photo into a bikini model image or video | | ai-bikini-photo-editor | AI bikini photo editor — edit a person photo into a bikini scene with a required prompt | | ai-blemish-remover | AI blemish remover — clean up acne and blemishes while keeping natural skin and facial details | | ai-christmas-photo | AI Christmas photo generator — transform a portrait into a festive Christmas scene | | ai-clothes-changer | AI clothes changer — dress a person (image 1) in the garment shown in another photo (image 2) | | ai-collage-maker | AI collage maker — create a chaotic multi-media collage from up to 10 images | | ai-couple-photo-maker | AI couple photo maker — combine two portrait photos into one realistic romantic couple image | | ai-dog | AI pet portrait generator — create or transform pet photos with a text prompt; image is optional | | ai-elf | AI elf filter — transform a portrait into a fantasy elf character | | ai-face-merge | AI face merge — blend two faces together into a single realistic portrait | | ai-feet | AI feet generator — generate a realistic low-angle bare feet photo from a portrait | | ai-flag-generator | AI flag generator — create a custom flag design from text or a reference image | | ai-generated-bikini-girls | AI generated bikini girls — transform a person photo into a bikini model image or video | | ai-generated-perfect-female-body | AI generated perfect female body — transform a person photo into a bikini model image or video | | ai-ghost-mannequin-generator | AI ghost mannequin generator — create a professional ghost mannequin effect from a clothing photo | | ai-group-photo-generator | AI group photo generator — create a creative group photo or collage from up to 10 images | | ai-hair-color-changer | AI hair color changer — change a person's hair color while preserving hairstyle and details | | ai-hairstyle-changer | AI hairstyle changer — change a person's hairstyle from a photo or text description | | ai-headshot-generator | AI headshot generator — create professional ID-style headshots from a single portrait photo | | ai-hot-girl-image | AI hot girl image — transform a person photo into a bikini model image or video | | ai-image-combiner | AI image combiner — naturally merge two photos into a single cohesive image | | ai-infographic-generator | AI infographic generator — turn a text description into a professional infographic layout | | ai-landscape-design-free | AI landscape designer — redesign a yard or outdoor space with a new landscape style | | ai-lingerie-models | AI lingerie models — transform a person photo into a bikini model image or video | | ai-lingerie-remover | AI lingerie remover — transform lingerie outfit photos into bikini look images or videos | | ai-logo-generator | AI logo generator — design brand logos from text descriptions, no reference image required | | ai-pants-remover | AI pants remover — transform pants outfit photos into bikini look images or videos | | ai-photoshoot | AI photoshoot — generate a professional photoshoot by combining a character photo and a reference scene | | ai-poster-from-images | AI poster generator — create a designed poster from up to 5 reference images | | ai-poster | AI poster generator — create a designed poster from text prompt and optional reference images | | ai-room-planner | AI room planner — redesign a room photo with a new interior design style | | ai-selfie | AI selfie generator — transform a portrait into a natural iPhone-style selfie photo | | ai-sexy-portrait | AI sexy portrait — transform a person photo into a bikini model image or video | | ai-sexy-teens | AI sexy teens — transform a person photo into a bikini model image or video | | ai-shirt-remover | AI shirt remover — transform a shirt outfit photo into a bikini look image or video | | ai-spray-paint | AI spray paint stencil maker — convert a photo into a black-and-white spray paint stencil | | ai-swimsuit-model | AI swimsuit model — transform a person photo into a swimsuit model image | | ai-tattoo-generator | AI tattoo generator — create a tattoo design try-on from text or reference image | | ai-translate | AI image text translator — translate text in an image to another language while preserving design | | ai-xray-clothes | AI x-ray clothes filter — make clothing appear sheer and see-through | | ai-zombie | AI zombie filter — transform a portrait into a realistic zombie | | aimodel | Fashion model photos — replace the model, swap the scene or background while keeping the garment | | aipose | Change the human pose in a photo while keeping the garment unchanged | | aiproduct | Product still-life photos — replace or enhance the background around a product | | anime-image-converter | AI anime image converter — transform any photo into anime art style | | baby-face-generator | AI baby face generator — predict what a baby would look like from two parent photos | | bald-filter | AI bald filter — make a person appear bald while preserving all other facial details | | bangs-filter | AI bangs filter — add natural-looking bangs to a person's hairstyle | | bikini-contest-photos | Bikini contest photos — transform a person photo into a bikini model image or video | | bikini-try-on | AI bikini try-on — virtually try on a bikini on a person photo | | braces-filter | AI braces filter — add dental braces to a person's teeth in a portrait photo | | brat-generator | AI brat generator — create a Charli XCX brat-style album cover meme with custom text and color | | buzz-cut-ai | AI buzz cut filter — change a person's hairstyle to a buzz cut | | celeb-ai | AI celebrity photo — place a person in a selfie with a celebrity or fictional character | | chibi-maker | AI chibi maker — convert a photo into a cute chibi character sticker | | clothing-magic-remover | AI clothing remover — erase accessories or partial clothing while keeping textures realistic | | custom-bikini | Custom bikini — transform a person photo into a bikini model image or video | | cute-anime-girl-ai-bikini | Cute anime girl AI bikini — transform a person photo into a bikini model image or video | | demon-slayer-oc-maker | AI Demon Slayer OC maker — transform a person into a Kimetsu no Yaiba anime character | | dress-remover-magic-eraser | AI dress remover — erase a dress and replace with a bikini while keeping body proportions | | expandimage | Expand the canvas to a larger size — AI fills the new area to blend naturally | | face-forge | AI face morph and face swap — generate or transform portraits | | fat-ai | AI plus-size body transformation — visualize how a person would look extremely overweight | | firered-image-edit | FireRed image editor — edit or generate images with high fidelity using FireRed open-source model | | flat-lay | AI flat-lay clothing generator — create professional flat-lay product images from a photo | | flowchart-generator | AI flowchart generator — create clear flowcharts from structured text descriptions | | free-ai-girlfriend-generator | AI girlfriend generator — generate a realistic AI girlfriend portrait from text or reference image | | free-sexy-ai-generator | Free sexy AI generator — transform a person photo into a bikini model image or video | | futuristic-elegance | Dress a person in futuristic harajuku fashion — cinematic sci-fi outfit transformation | | gender-swap | AI gender swap — transform a portrait to the opposite gender while preserving identity | | ghibli-art-create | AI Ghibli art creator — transform any photo into Studio Ghibli anime art style | | gpt-image | GPT Image 2 image generator — create high-quality images, text-rich visuals, and product photography from prompts | | grok-imagine | Grok Imagine image generator — create high-resolution images from text using xAI Aurora | | hair-color-try-on | Hair color try-on — change a person's hair color while preserving hairstyle and details | | happy-woman-bikini-ai-pic | Happy woman bikini AI pic — transform a person photo into a bikini model image or video | | hot-bikini-models | Hot bikini models — transform a person photo into a bikini model image or video | | image-mixer | Image mixer — naturally merge two photos into a single cohesive image | | image-to-sketch | AI image to sketch — convert a photo into a rough pencil sketch | | midjourney | Midjourney image generator — create high-quality images using Midjourney v6.1, v7, or Niji 6 | | mugshot-creator | AI mugshot creator — generate a police-style mugshot photo from a portrait | | murder-drones-oc | AI Murder Drones OC maker — transform a person into a Murder Drones-inspired robotic drone character | | nano-banana-edit | Nano Banana image editor — generate or edit images with Nano Banana, Nano Banana Pro, or Nano Banana 2 using Google's Gemini-based models | | outfit-generator | AI outfit generator — redesign a complete outfit on a person photo based on style prompt | | personalized-swimsuit | Personalized swimsuit — transform a person photo into a bikini model image or video | | photo-to-bikini-ai | AI photo to bikini converter — transform a person photo into a bikini image | | photo-wrinkle-remover | Photo wrinkle remover — smooth facial wrinkles in portrait photos while keeping natural skin texture | | pregnant-ai | Visualize how a person would look pregnant — transforms a portrait photo | | ps2-filter | AI PS2 filter — transform a photo into a retro PS2-era Sims game character | | qwen-image-edit | AI image editing — edit or generate images with natural language instructions using Qwen | | random-animal-generator | AI random animal generator — generate a hyper-realistic wildlife photo of any animal | | remove-filter-from-photo | AI filter remover — remove photo filters and restore natural image colors | | removebg | Remove the background or replace it with a solid color | | see-through-clothes-fitler | See-through clothes filter — make clothing appear sheer and see-through | | seedream | AI image generation — create and edit images using Seedream 5.0 model by ByteDance | | sex-ai-generator | Sex AI generator — transform a person photo into a bikini model image or video | | sexy-ai-pics | AI sexy pics generator — generate stylish and attractive photos from a person image | | skin-color-changer | AI skin color changer — change a person's skin tone while preserving face details | | sonic-oc | AI Sonic OC maker — create a Sonic the Hedgehog original character based on a person's appearance | | sprunki-oc-maker | AI Sprunki OC maker — create a Sprunki-style original character from a person photo | | square-face-icon-generator | AI square face icon generator — create a minimalist anime-style square face avatar from a photo | | stardew-valley-portrait-maker | AI Stardew Valley portrait maker — create a Stardew Valley game-style character portrait | | string-bikini-beauty-contest | String bikini beauty contest — transform a person photo into a bikini model image or video | | swimsuit-try-on-haul | Swimsuit try-on haul — transform a person photo into a bikini model image or video | | virtualtryon | Virtual try-on — put a garment onto a generated model with optional model/background references | | wild-graffiti | AI wild graffiti generator — create wild-style spray paint graffiti art from text or image | | z-image | AI image generation — create high-quality images from text with Z-Image by Alibaba |

Video Agents

| Command | What it does | |---|---| | ai-bikini-video | AI bikini video generator — generate a bikini dance video from a person photo | | ai-image-animation | AI image animation — animate a static image into a dynamic video using Kling | | ai-text-remover-from-video | AI text remover from video — remove text overlays or watermarks from a video | | ai-video-enhancer | AI video enhancer — upscale and enhance video quality using AI | | ai-werewolf | AI werewolf generator — create a dramatic werewolf transformation video from a person photo | | free-4k-video-upscaler | Free 4K video upscaler — upscale video to 4K resolution using AI | | free-online-video-quality-enhancer | Free online video quality enhancer — upscale and enhance video quality using AI | | gemini-watermark-remover | Gemini watermark remover — remove watermarks, logos, or text from a video | | grok-imagine-video | Grok Imagine video generator — create cinematic AI videos with native audio using xAI | | hailuo-ai | Hailuo AI video generator — create cinematic AI videos from images and text using MiniMax Hailuo models | | happyhorse | HappyHorse AI video generator — create cinematic text-to-video and image-to-video clips with native 1080p output | | improve-video-quality-online-free | Improve video quality online free — upscale and enhance video quality using AI | | kling-motion-control | Kling Motion Control — transfer motion from a reference video onto a character image with identity preservation | | kling | AI video generation — create cinematic videos from images and text using Kling | | logo-remover-from-video | Logo remover from video — remove logos or watermarks from a video | | remove-subtitles-from-video-online-free | Remove subtitles from video online free — remove subtitles or text overlays from a video | | remove-text-from-video-online-free | Remove text from video online free — remove text overlays or watermarks from a video | | replace-face-in-video-online-free | AI video face swap — replace a face in a video with a reference face photo | | seedance | Seedance video generator — create cinematic AI videos using Seedance 2.0 by ByteDance | | sora-2 | Cinematic video generation with realistic physics using OpenAI Sora 2 | | veo-ai | Veo 3 AI video generator — create cinematic videos from images and text using Google Veo 3.1 models | | video-resolution-enhancer-online-free | Video resolution enhancer online free — upscale and enhance video resolution using AI | | video-upscaler-online-free | Video upscaler online free — upscale and enhance video quality using AI | | video-watermark-remover | AI video watermark remover — remove watermarks, logos, or text from a video | | vidu-ai | Vidu Q3 AI video generator — create cinematic short videos with Vidu Q3 Pro or Pro Fast modes | | wan-ai | Wan AI video generator — create AI videos from images and text using Wan AI |

Example: virtual try-on

weshop virtualtryon \
  --image ./garment.png \
  --model-image ./model-photo.png \
  --gen-version weshopPro \
  --prompt-mode auto \
  --aspect-ratio 2:3 \
  --batch 2

Output:

[image]
  imageUrl: https://ai-global-image.weshop.com/...

[submitted]
  executionId: abc123

[result]
  agent: virtualtryon v1.0
  executionId: abc123
  status: Success
  imageCount: 2
  image[0]:
    status: Success
    url: https://ai-global-image.weshop.com/...
  image[1]:
    status: Success
    url: https://ai-global-image.weshop.com/...

Example: AI video generation

# Kling — cinematic video with audio
weshop kling \
  --image ./scene.png \
  --prompt 'Camera slowly pans across a misty forest' \
  --model Kling_3_0 \
  --duration 8s \
  --generate-audio true

# Seedance — ByteDance video model
weshop seedance \
  --image ./photo.png \
  --prompt 'Person walks in slow motion' \
  --model Seedance_15_Pro \
  --duration 8s \
  --aspect-ratio 16:9

# Sora 2 — OpenAI video model
weshop sora-2 \
  --image ./landscape.png \
  --prompt 'Time-lapse of clouds moving' \
  --duration 8s

Example: use preset IDs for best results

For aimodel and aiproduct, using preset scene/model IDs gives the best quality. List them with info:

# See available scenes and models
weshop info aimodel

# Use a preset scene
weshop aimodel \
  --image ./model.png \
  --mask-type autoApparelSegment \
  --generation-mode referToOrigin \
  --location-id 6000372 \
  --batch 2

Async mode

Don't want to wait? Add --no-wait and poll later:

weshop kling --image ./scene.png --prompt 'Ocean waves' --no-wait
# [submitted]
#   executionId: abc123
# [info]
#   message: Use 'weshop status abc123' to check progress

weshop status abc123
# [result]
#   agent: kling v1.0
#   status: Success
#   ...

For AI agents

The output is designed to be easily parsed by automated tools and AI agents:

• Structured [section] + key: value format — no ANSI colors, no progress bars
• Every field is labeled and parseable
• --no-wait + weshop status enables non-blocking workflows
• --help on each command documents every parameter, enum value, and constraint
• Local images are auto-uploaded and cached — no separate upload step needed

License

Apache-2.0