# Pixshop - AI Creative Platform
# https://pixshop.app
# For AI agents and LLMs

> Pixshop is an AI-powered creative platform with 28+ callable tools for image generation, editing, video creation, and e-commerce content.

## Quick Start

1. Authenticate: POST /api/auth/login → get Bearer token
2. Discover tools: GET /api/agent/discover → JSON Schema for all tools
3. Call a tool: POST /api/agent/chat (with tool invocation)
4. Check credits: GET /api/credits/balance

## API Base URL

https://pixshop.app

## Authentication

All tool calls require a Supabase JWT Bearer token.
Header: `Authorization: Bearer <token>`

## Machine-Readable Endpoints

- Tool Discovery (JSON Schema): GET /api/agent/discover
- Skills List: GET /api/agent/skills
- Agent Chat: POST /api/agent/chat
- Full Documentation: /llms-full.txt
- AI Plugin Manifest: /.well-known/ai-plugin.json

## Tool Catalog

### Generation (image creation from text)
- image-generate: Generate images from text prompts (2 credits)
- flux-generate: High-quality image generation with Flux model (3 credits)

### Video
- video-generate: Generate video from image + motion prompt (6 credits)

### Editing (modify existing images)
- image-edit: General image editing with AI instructions (1 credit)
- image-inpaint: Masked region repair/replacement (2 credits)
- background-remove: Remove image background (1 credit)
- style-transfer: Convert image to artistic styles (2 credits)
- outpaint: Extend image beyond its borders (3 credits)
- reference-guide: Generate images using reference guidance (3 credits)
- image-fusion: Fuse multiple images together (2 credits)
- texture-transfer: Apply texture effects to images (2 credits)
- age-transform: Transform to different decade photo styles (2 credits)
- virtual-tryon: Virtual clothing try-on (2 credits)
- id-photo: Professional ID photo generation (2 credits)

### Enhancement
- image-upscale: Upscale image resolution 2x or 4x (3 credits)

### Prompt Library
- prompt-search: Search curated prompt templates (free)
- prompt-recommend: Get AI prompt recommendations (free)

### Apps
- app-list: List available Nano Banana AI apps (free)
- app-execute: Execute a specific AI app (varies)

### Social
- post-publish: Publish creation to community (free)
- remix-start: Start a remix from existing work (free)

### Effects (Pika-style creative effects)
- inflate: 3D inflate effect on images (2 credits)
- melt: Melting effect on images (2 credits)
- explode: Explosion effect on images (2 credits)
- cakeify: Turn objects into cake (2 credits)

### Commercial (e-commerce)
- product-placement: Place product in scene (3 credits)
- product-showcase: Generate product showcase images (3 credits)
- ecommerce-template: Apply e-commerce templates (2 credits)

## Credits System

Each tool has a credit cost (0 = free, -1 = varies by config).
Check balance: GET /api/credits/balance
New users receive bonus credits on signup.

## Supported Languages

en, zh, ja, ko, es, de, fr