Metadata-Version: 2.4
Name: pixelapi
Version: 0.1.0
Summary: Python SDK for PixelAPI — AI image generation API
Home-page: https://pixelapi.dev
Author: PixelAPI
Author-email: PixelAPI <support@pixelapi.dev>
License-Expression: MIT
Project-URL: Homepage, https://pixelapi.dev
Project-URL: Documentation, https://pixelapi.dev/docs
Project-URL: Repository, https://github.com/pixelapi/pixelapi-python
Keywords: ai,image-generation,stable-diffusion,flux,sdxl,api
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Multimedia :: Graphics
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# PixelAPI Python SDK

AI image generation at **$0.01/image**. SDXL and FLUX Schnell on bare-metal GPUs.

## Install

```bash
pip install pixelapi
```

## Quick Start

```python
from pixelapi import PixelAPI

api = PixelAPI("your-api-key")

# Generate and wait for result
result = api.generate("a sunset over mountains, oil painting", model="sdxl", wait=True)
print(result.output_url)

# Or use FLUX for photorealism
result = api.generate("a coffee shop on a rainy day", model="flux-schnell", wait=True)
print(result.output_url)
```

## Async / Non-blocking

```python
# Submit without waiting
result = api.generate("a cyberpunk cityscape", model="sdxl")
print(result.generation_id)  # save this

# Check later
status = api.get_status(result.generation_id)
if status.completed:
    print(status.output_url)
```

## Download Images

```python
result = api.generate("a cute robot", model="sdxl", wait=True)
image_bytes = api.download(result.output_url)

with open("robot.png", "wb") as f:
    f.write(image_bytes)
```

## Check Balance

```python
balance = api.balance()
print(balance)
```

## Models & Pricing

| Model | Credits | Price |
|-------|---------|-------|
| `sdxl` | 1 | $0.01 |
| `flux-schnell` | 3 | $0.03 |

100 free credits on signup — no credit card required.

## Error Handling

```python
from pixelapi import PixelAPI, PixelAPIError

api = PixelAPI("your-api-key")

try:
    result = api.generate("hello world", model="sdxl", wait=True)
except PixelAPIError as e:
    print(f"Error: {e} (HTTP {e.status_code})")
```

## Links

- **Website:** https://pixelapi.dev
- **Docs:** https://pixelapi.dev/docs
- **Dashboard:** https://pixelapi.dev/app/
