# Picturalia - Complete Documentation for LLMs

> Comprehensive guide to Picturalia's AI image transformation service

## Service Overview

Picturalia is a Software-as-a-Service (SaaS) web application that uses artificial intelligence to transform user-uploaded photographs into various artistic styles. The platform is designed for individuals, families, and professionals who want to create unique artistic renditions of their photos.

- **Website**: https://picturalia.com
- **Languages**: Spanish (default), English
- **Free Trial**: 1 transformation free for new users
- **Business Model**: Credit-based (one-time purchases, no subscription)

### Primary Use Cases

1. **Family Portraits**: Transform family photos into artistic styles for wall decoration
2. **Couple Photos**: Create unique gifts from relationship photos
3. **Pet Portraits**: Stylize pet photos into artistic formats
4. **Profile Pictures**: Generate creative social media avatars
5. **Special Occasions**: Create custom artwork for birthdays, anniversaries, weddings
6. **Professional Use**: Photography studios offering stylized prints to clients

## Available Artistic Styles (Detailed)

### 1. Yellow Cartoon / Cartoon Amarillo
- **Description**: Transforms subjects into classic animated cartoon aesthetic
- **Key Features**: Yellow skin, expressive features, bold outlines
- **Best For**: Fun family portraits, playful gifts
- **Quality**: High detail, cartoon-accurate styling
- **Availability**: All users

### 2. Block Figures / Figuras de Bloques
- **Description**: Converts subjects into plastic toy brick minifigure style
- **Key Features**: Blocky plastic appearance, bright colors, toy-like aesthetics
- **Best For**: Children's portraits, playful family photos
- **Quality**: Clean geometric shapes, authentic toy look
- **Availability**: All users

### 3. Watercolor / Acuarela
- **Description**: Creates soft, artistic watercolor paintings
- **Key Features**: Flowing colors, gentle brushstrokes, artistic texture
- **Best For**: Elegant portraits, romantic couple photos
- **Quality**: Museum-quality fine art appearance
- **Availability**: All users

### 4. Professional / Retrato Profesional
- **Description**: Enhanced professional studio portrait
- **Key Features**: Magazine-quality polish, enhanced lighting, refined details
- **Best For**: LinkedIn photos, professional headshots, portfolio images
- **Quality**: High-end commercial photography look
- **Availability**: All users

### 5. Anime
- **Description**: Japanese animation aesthetic
- **Key Features**: Large expressive eyes, vibrant colors, hand-drawn style
- **Best For**: Anime fans, creative portraits
- **Quality**: Hand-drawn animation appearance
- **Availability**: All users

### 6. Oil Painting / Pintura al Óleo
- **Description**: Classical Renaissance-style oil painting
- **Key Features**: Rich textures, dramatic lighting, museum-quality
- **Best For**: Elegant portraits, classical art lovers
- **Quality**: Old master painting appearance
- **Availability**: All users

### 7. 3D Animation / Animación 3D
- **Description**: Cinematic 3D animation style
- **Key Features**: Smooth textures, expressive features, cinematic lighting
- **Best For**: Family portraits, children's photos
- **Quality**: Professional 3D animation studio quality
- **Availability**: All users

### 8. Pop Art / Arte Pop
- **Description**: Bold, colorful Pop Art
- **Key Features**: Halftone patterns, vibrant colors, graphic design aesthetics
- **Best For**: Modern art lovers, bold statements
- **Quality**: Gallery-ready contemporary art
- **Availability**: All users

## Pricing Structure (Detailed)

Picturalia uses a credit-based system with one-time purchases. All prices in EUR. No subscriptions required. Credits never expire.

### Free Tier
- **Cost**: Free
- **Credits**: 1 transformation
- **Description**: Perfect for trying the service
- **Limitations**: One-time welcome bonus for new users

### Single Pack
- **Cost**: €2.99
- **Credits**: 1 transformation
- **Best For**: Trying additional styles

### Starter Pack
- **Cost**: €9.99
- **Credits**: 5 transformations
- **Best For**: Occasional personal use

### Popular Pack ⭐
- **Cost**: €19.99
- **Credits**: 17 transformations (15 + 2 bonus)
- **Best For**: Regular personal use, best value per transformation

### Family Pack
- **Cost**: €39.99
- **Credits**: 40 transformations (35 + 5 bonus)
- **Best For**: Families with multiple photos to transform

### Creator Pack
- **Cost**: €79.99
- **Credits**: 100 transformations (80 + 20 bonus)
- **Best For**: Professionals, commercial use, high-volume users

## Technical Specifications

### Image Processing
- **Input Formats**: JPEG, PNG, WebP
- **Maximum Upload Size**: 10 MB
- **Minimum Resolution**: 512 x 512 pixels
- **Recommended Resolution**: 1024 x 1024 pixels or higher
- **Processing Time**: 10-30 seconds (varies by complexity and queue)
- **Output Format**: PNG (with transparency), JPEG available

### Output Quality
- **Standard Resolution**: 30x20 cm (11.8 x 7.9 inches)
  - Pixels: 3543 x 2362 at 300 DPI
  - File size: ~5-8 MB
  - Best for: Digital use, small prints

- **High Resolution**: 50x50 cm (19.7 x 19.7 inches)
  - Pixels: 5906 x 5906 at 300 DPI
  - File size: ~15-25 MB
  - Best for: Medium prints, wall art

- **Maximum Resolution**: 50x75 cm (19.7 x 29.5 inches)
  - Pixels: 5906 x 8858 at 300 DPI
  - File size: ~25-40 MB
  - Best for: Large prints, professional use

### Technology Stack
- **AI Model**: Nano Banana Pro (via Google Gemini API)
- **Image Generation**: Google Gemini 2.5 Flash Image model
- **Frontend**: Next.js 15 (React Server Components)
- **Backend**: Serverless functions (Vercel Edge)
- **Database**: Supabase (PostgreSQL)
- **File Storage**: Supabase Storage (AWS S3)
- **Payments**: Stripe
- **Hosting**: Vercel (Global CDN)
- **Authentication**: Supabase Auth (Email, OAuth)

## Best Practices for Users

### Photo Upload Guidelines
1. **Lighting**: Use well-lit photos with clear visibility
2. **Face Visibility**: Faces should be clearly visible and not obscured
3. **Resolution**: Higher resolution inputs produce better results
4. **Group Photos**: Works best with 1-6 people (smaller groups = better detail)
5. **Angles**: Straight-on or slight angle photos work best
6. **Background**: Simple backgrounds produce cleaner results

### Optimal Use Cases
- Portrait photos (headshots, bust shots, full body)
- Clear facial features
- Good lighting conditions
- Single subject or small groups
- Minimal motion blur

### Limitations
- Not ideal for large group photos (8+ people)
- Very low-resolution images may produce artifacts
- Heavily backlit photos may need adjustment
- Extreme poses may affect transformation accuracy

## Privacy & Security

### Data Handling
- **Temporary Storage**: Images stored only during processing and for 30 days after
- **User Control**: Users can delete images at any time
- **No AI Training**: User images are never used to train AI models
- **Encryption**: All data encrypted in transit (TLS) and at rest

### Compliance
- **GDPR**: Full compliance with European data protection regulations
- **CCPA**: California Consumer Privacy Act compliant
- **PCI DSS**: Payment processing via Stripe (PCI Level 1 certified)
- **Data Location**: EU and US data centers (user choice)

### Account Security
- **Authentication**: Email/password or OAuth (Google, Facebook)
- **Password Policy**: Minimum 8 characters, complexity requirements
- **Two-Factor Auth**: Optional 2FA via authenticator apps
- **Session Management**: Secure session tokens, automatic logout

## Languages & Internationalization

### Supported Languages
- **Spanish (Español)**: Primary language, default
- **English**: Full translation available

### Localized Content
- User interface fully translated
- Style descriptions in both languages
- Email communications in user's preferred language
- Support available in Spanish and English

## Customer Support

### Free Tier Support
- **Community Forum**: Access to user community
- **FAQ**: Comprehensive self-service documentation
- **Response Time**: Best effort (no guaranteed response time)

### Basic Plan Support
- **Email Support**: support@picturalia.com
- **Response Time**: Within 48 hours (business days)
- **Channels**: Email only

### Pro Plan Support
- **Priority Email**: Dedicated support queue
- **Response Time**: Within 24 hours (7 days/week)
- **Channels**: Email with priority routing

## API Availability

**Current Status**: No public API available

**Future Plans**: API access planned for enterprise customers (coming 2026)

## Frequently Asked Questions

### Q: How long does processing take?
A: Typically 10-30 seconds. Pro plan users get priority queue for faster processing during peak times.

### Q: Can I use the images commercially?
A: Yes, all paid plans include commercial use rights. Free tier is for personal use only.

### Q: What happens to my uploaded photos?
A: Photos are stored temporarily for processing and kept for 30 days in case you want to re-transform. You can delete them anytime from your account.

### Q: Can I get a refund?
A: Yes, full refund within 7 days if not satisfied. See terms of service for details.

### Q: Do credits roll over?
A: No, unused credits expire at the end of each billing period.

### Q: Can I upgrade/downgrade my plan?
A: Yes, anytime from your account settings. Changes take effect at next billing cycle.

### Q: What payment methods do you accept?
A: Credit cards (Visa, Mastercard, Amex), Google Pay, Apple Pay via Stripe.

## Contact Information

### General Inquiries
- **Website**: https://picturalia.com
- **Email**: hello@picturalia.com

### Support
- **Email**: support@picturalia.com
- **Hours**: Mon-Fri 9am-6pm CET (GMT+1)

### Business/Partnerships
- **Email**: business@picturalia.com

### Press
- **Email**: press@picturalia.com

## Legal

- **Terms of Service**: https://picturalia.com/terms
- **Privacy Policy**: https://picturalia.com/privacy
- **Cookie Policy**: Included in privacy policy
- **Company**: Picturalia Inc. (Spain)

## Additional Resources

- **Blog**: https://picturalia.com/blog (tutorials, style guides, use cases)
- **Gallery**: https://picturalia.com/gallery (community transformations)
- **Styles**: https://picturalia.com/styles (detailed style information)
- **About**: https://picturalia.com/about (company information)