PicX CLI

AI Image Generation
from the Terminal.

Generate and edit stunning images using multi-model AI. Built for developers, content creators, and AI agents like Claude Code and OpenClaw.

npm i -g github:Type-Think-AI/picx-cli
terminal
$ picx generate "pro headshot,
  studio lighting, clean bg"

{
  "success": true,
  "url": "https://cdn...",
  "credits_used": 20
}
2
AI Models
5
CLI Commands
3
Resolutions
JSON
Structured Output

Built for Automation

Every command outputs structured JSON. Designed for AI agents, scripts, and pipelines.

AI Agent Ready

Structured JSON output. Claude Code, OpenClaw, and any LLM can parse and execute image workflows.

Generate Images

Text-to-image with multiple AI models. Headshots, product mockups, social media content.

Edit Images

AI-powered editing. Change backgrounds, adjust lighting, remove objects, apply styles.

Multi-Model

Choose from Vertex AI models. Fast with Nano Banana 2 or premium with Nano Banana Pro.

Any Resolution

1K, 2K, or 4K with flexible aspect ratios: 1:1, 16:9, 9:16, 4:3, 3:2.

REST API + CLI

Use CLI from terminal or REST API from any language — Python, JS, cURL, Go, Ruby.

Quick Start

Get Started in Seconds

1

Install & authenticate

# Install from GitHub
npm install -g github:Type-Think-AI/picx-cli

# Set your API key (get one at picxstudio.com/api)
export PICX_API_KEY=pxsk_YOUR_KEY

# Verify
picx auth
2

Generate your first image

picx generate "a sunset over mountains, oil painting style"

# With options
picx generate "neon cyberpunk city at night" \
  --model gemini-3-pro-image-preview \
  --size 2K --aspect-ratio 16:9
Response
{
  "success": true,
  "id": "img_537f439a4e58",
  "url": "https://cdn.picxstudio.com/api/generated/image_8871aa96.png",
  "model": "gemini-3-pro-image-preview",
  "size": "2K",
  "aspect_ratio": "16:9",
  "credits_used": 50
}
3

Edit existing images

picx edit "make it nighttime with city lights" \
  --image-url https://cdn.picxstudio.com/api/generated/image.png

picx edit "remove background, add clean white studio backdrop" \
  --image-url ./photo.jpg --size 2K
For Content Creators

Create Content at Scale

Generate professional images for social media, blogs, marketing — all from the terminal.

Social Media Content

Instagram posts, YouTube thumbnails, Twitter banners — any size, any style.

# Instagram post (square)
picx generate "minimal flat-lay coffee, aesthetic" \
  --aspect-ratio 1:1

# YouTube thumbnail (wide)
picx generate "bold dramatic thumbnail" \
  --aspect-ratio 16:9 --size 2K

# Instagram story (vertical)
picx generate "behind the scenes shot" \
  --aspect-ratio 9:16

Edit & Transform

Change backgrounds, seasons, styles, or fix lighting on any image.

# Clean headshot background
picx edit "white studio backdrop, enhance" \
  --image-url ./selfie.jpg

# Style transfer
picx edit "anime art style, vibrant" \
  --image-url ./photo.jpg --size 2K

# Batch edit a folder
for img in ./photos/*.jpg; do
  picx edit "vintage film grain" \
    --image-url "$img"
done

Works with AI Agents

PicX CLI is an OpenClaw skill. Any AI agent that can run shell commands can generate images.

🦀

OpenClaw

Personal AI Agent

OpenClaw reads the bundled SKILL.md to discover all PicX commands. Message from WhatsApp, Telegram, or Slack — it handles the rest.

Install from GitHub
# Install the PicX CLI globally
npm install -g github:Type-Think-AI/picx-cli

# Set your API key
export PICX_API_KEY=pxsk_YOUR_KEY

# Verify OpenClaw sees it
openclaw skills list --eligible
WhatsApp / Telegram
You:
Generate a professional headshot with studio lighting, clean white background
OpenClaw:
Done! Image generated.
https://cdn.picxstudio.com/... | 20 credits

Claude Code

by Anthropic

Claude reads SKILL.md to learn PicX commands. It autonomously generates images, picks models, and manages your workflow.

Claude Code
> Generate a hero banner for my blog
  about AI trends, wide format,
  futuristic vibes

Claude will run:
  picx models
  picx generate "futuristic AI trends
    hero banner, digital art" \
    --aspect-ratio 16:9 \
    --model gemini-3-pro-image-preview \
    --size 2K
Reads SKILL.md for command discovery
Picks optimal model automatically
Works with any LLM backend
SKILL.md (auto-discovered by AI agents)
---
name: picx
description: AI image generation CLI. Generate and edit images
  using PicX Studio's multi-model API.
metadata:
  openclaw:
    requires:
      env:
        - PICX_API_KEY
      bins:
        - picx
    primaryEnv: PICX_API_KEY
    homepage: https://picxstudio.com/developer
---

# Commands
- picx generate <prompt>    Generate an image from text
- picx edit <instruction>   Edit an image with AI
- picx models               List available models + credit costs
- picx usage                Show API usage stats
Pricing

Models & Credits

Choose the right model. Credits vary by model and resolution.

ModelName1K2K4KBest For
gemini-3.1-flash-image-previewNano Banana 2202040Fast drafts, social, batch
gemini-3-pro-image-previewNano Banana Pro5050100Premium, hero images, print
List models live
picx models
Reference

Commands

CommandDescription
picx generate <prompt>Generate an image from a text prompt
picx edit <instruction> --image-url <url>Edit an image with an AI instruction
picx modelsList all available models and credit costs
picx authCheck API key authentication status
picx usage [--period 30d]Show API usage statistics
Generate Options
--model Model ID (default: flash)
--size 1K | 2K | 4K
--aspect-ratio 1:1 | 16:9 | 9:16 | 4:3 | 3:2
Edit Options
--image-url Source image URL (required)
--model Model ID (default: flash)
--size 1K | 2K | 4K

Why AI Agents Love PicX

Every command returns structured JSON
Built-in SKILL.md for command discovery
Agents can explore models and costs
No SDK needed — just CLI commands
Model-agnostic — Claude, GPT, Gemini, Llama
Permanent CDN URLs — images never expire
Credit-based — pay only for what you generate
Auto-refund on server errors

Start Generating Images

Free credits to get started. No credit card required.

npm i -g github:Type-Think-AI/picx-cli
PicX StudioPicX Studio by TypeThink AI
APICreditsAboutGitHub