# Logo Creator

Generate 6 logo designs in 3x2 grid from a text brand name for brand identity workflows.

## Description

Input a brand name and receive a 3x2 grid containing 6 distinct logo designs. Each design showcases a different style (minimalist, modern, vintage, bold, elegant, playful), making it ideal for brand identity exploration and logo concept generation.

## Authentication

**Required**: x402 payment

This endpoint requires payment via the x402 protocol. See the [Setup](./setup.md) for setup instructions.

## Request

**Endpoint**: `POST /api/logo-creator/generate`

**Content-Type**: `multipart/form-data`

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| brand | string | Yes | Brand name (max 200 characters), e.g., "Acme Corp" |

## Response

**200 OK**

```json
{
  "imageUrl": "/outputs/uuid-here.png"
}
```

| Field | Type | Description |
|-------|------|-------------|
| imageUrl | string | Path to the generated logo grid image |

## Error Codes

| Status | Code | Description |
|--------|------|-------------|
| 400 | VALIDATION_ERROR | Brand name is required, must be non-empty, and under 200 characters |
| 402 | PAYMENT_REQUIRED | x402 payment not completed |
| 422 | INVALID_REQUEST | Unable to process request |
| 500 | INTERNAL_ERROR | AI generation failed |
| 504 | AI_GENERATION_TIMEOUT | AI request timed out |

## Example

### Generate logo designs

```bash
npx x402-proxy -X POST \
  -F "brand=Acme Corp" \
  https://ps.codejar.net/api/logo-creator/generate
```

**Response:**
```json
{
  "imageUrl": "/outputs/550e8400-e29b-41d4-a716-446655440004.png"
}
```

## Output Format

The generated image is a single combined grid containing:
- **3x2 grid layout** (6 logo panels total)
- **Diverse styles**: Each logo showcases a different design style
- **Professional quality**: Suitable for brand identity use
- **High resolution**: Suitable for various applications

## Logo Styles Included

The 6 generated logos include variations of:
- **Minimalist**: Clean, simple designs with limited elements
- **Modern**: Contemporary and sleek design approaches
- **Vintage**: Classic and timeless aesthetic
- **Bold**: Strong, impactful visual presence
- **Elegant**: Refined and sophisticated designs
- **Playful**: Fun and creative approaches

## Use Cases

- **Brand Identity**: Explore logo concepts for new brands
- **Rebranding**: Generate logo alternatives for existing brands
- **Design Inspiration**: Get multiple design directions quickly
- **Client Presentations**: Offer variety in logo proposals
- **Startup Branding**: Quick logo concepts for new ventures