Metadata-Version: 2.4
Name: crayonz
Version: 0.1.4
Summary: Official Python SDK for the Crayonz AI API — meme, content, and design generation.
Project-URL: Homepage, https://crayonz.ai/api-console
Project-URL: Documentation, https://crayonz.ai/api-console/docs
Project-URL: Source, https://github.com/iitian-vibes/crayonz-sdks
Project-URL: Issues, https://github.com/iitian-vibes/crayonz-sdks/issues
Author-email: Aivolvix Technologies <support@crayonz.ai>
License: MIT
License-File: LICENSE
Keywords: ai,content-generation,crayonz,design-generation,memes
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Requires-Dist: httpx>=0.25
Requires-Dist: typing-extensions>=4.5; python_version < '3.11'
Description-Content-Type: text/markdown

# crayonz

Official Python SDK for the [Crayonz AI](https://crayonz.ai) API — meme, content, and design generation.

## Install

```bash
pip install crayonz
```

## Quickstart

```python
from crayonz import Client

client = Client(api_key="cz_live_...")  # or os.environ["CRAYONZ_API_KEY"]

# Generate memes
memes = client.memes.generate(topic="coding", tone="sarcastic", count=3)
print(memes["memes"][0]["image_url"])

# Generate a blog post
blog = client.content.generate_blog(topic="campus life productivity", target_length=1500)

# Generate a design
design = client.design.generate(prompt="minimalist mountain logo", style="vector")
```

## Authentication

Get an API key at [crayonz.ai/api-console/keys](https://crayonz.ai/api-console/keys). Keys begin with `cz_live_` (production) or `cz_test_` (sandbox, free).

## Cost-allocation tags

Group usage across projects:

```python
client = Client(api_key="cz_live_...", tag="project=launch-campaign")
```

The tag shows up in the [usage dashboard](https://crayonz.ai/api-console/usage) under "By Tag".

## Error handling

```python
from crayonz import Client, CrayonzError

try:
    client.memes.generate(topic="x")
except CrayonzError as e:
    print(e.status, e.endpoint, e.body)
```

## Context manager

```python
with Client(api_key="cz_live_...") as client:
    trends = client.design.discover_trends(category="apparel")
```

## Configuration

```python
Client(
    api_key="cz_live_...",
    tag="project=foo",        # optional cost tag
    timeout=60.0,             # default 60s
    base_urls={               # override service URLs (rare)
        "memes": "https://...",
        "content": "https://...",
        "design": "https://...",
    },
)
```

## Requirements

Python 3.9+.

## License

MIT
