# PixelForge AI

> PixelForge AI is an AI image generator and a free stock-image library. Generate original images from a text prompt, or browse and download thousands of AI-generated images that are free for commercial and personal use under the PixelForge Free License. There is a public, credit-metered REST API so agents can generate and search images programmatically.

## Key pages

- [Gallery](https://pixelforgeai.dev/gallery): Browse the free AI image library.
- [Newest](https://pixelforgeai.dev/newest): Most recently added images.
- [Popular](https://pixelforgeai.dev/popular): Most upvoted images.
- [Blog](https://pixelforgeai.dev/blog): Guides, tutorials, and AI image news.
- [Glossary](https://pixelforgeai.dev/glossary): Definitions of AI image generation terms.
- [AI Art Styles](https://pixelforgeai.dev/styles): Browse and generate images by art style.
- [AI Makers](https://pixelforgeai.dev/create): Purpose-built AI generators for thumbnails, logos, and more.
- [License](https://pixelforgeai.dev/license): The PixelForge Free License - free for commercial and personal use, no attribution required.
- [Developers](https://pixelforgeai.dev/developers): REST API documentation and quickstart.
- [OpenAPI spec](https://pixelforgeai.dev/api/v1/openapi.json): Machine-readable OpenAPI 3.1 definition.
- [Pricing](https://pixelforgeai.dev/pricing): Plans and credits.

## API quickstart (for agents)

Base URL: `https://pixelforgeai.dev/api/v1`
Auth: `Authorization: Bearer pf_live_...` (create a key in the dashboard).
Envelope: success responses are `{ "data": ... }`; errors are `{ "error": { "code", "message" } }`.

Generate an image (costs credits; the free daily allowance is consumed first):

```
curl -X POST https://pixelforgeai.dev/api/v1/images/generate \
  -H "Authorization: Bearer pf_live_..." \
  -H "Content-Type: application/json" \
  -d '{"prompt":"a serene Swiss mountain lake at golden hour","aspectRatio":"16:9"}'
```

Browse / search the free stock library (no credits charged):

```
curl "https://pixelforgeai.dev/api/v1/images?filter=style:watercolor&sort=popular&limit=24" \
  -H "Authorization: Bearer pf_live_..."
```

## Capabilities

- Image generation: text-to-image across multiple models. See https://pixelforgeai.dev/api/v1/models.
- Stock search: browse by category, tag, or prefixed style filter (e.g. `style:watercolor`); sort by recent or popular; cursor pagination.
- Image metadata: https://pixelforgeai.dev/api/v1/images/{idOrSlug} returns prompt, model, SEO, license, and a free web-resolution download URL.
- Account: https://pixelforgeai.dev/api/v1/me returns credits, today's free allowance, and plan tier.