Metadata-Version: 2.4
Name: apiz
Version: 0.1.0
Summary: Official Python SDK for the apiz.ai AI generation platform
Project-URL: Homepage, https://apiz.ai
Project-URL: Documentation, https://apiz.ai/docs
Project-URL: Repository, https://github.com/xuliang2024/apiz-sdk
Project-URL: Issues, https://github.com/xuliang2024/apiz-sdk/issues
Author: apiz.ai
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: ai,apiz,apiz.ai,image-generation,sdk,tts,video-generation
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
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<1,>=0.27.0
Requires-Dist: pydantic<3,>=2.6
Requires-Dist: typing-extensions>=4.10
Provides-Extra: dev
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest-cov>=5; extra == 'dev'
Requires-Dist: pytest-httpx>=0.30; extra == 'dev'
Requires-Dist: pytest>=8.2; extra == 'dev'
Requires-Dist: respx>=0.21; extra == 'dev'
Requires-Dist: ruff>=0.6; extra == 'dev'
Description-Content-Type: text/markdown

# apiz (Python)

Official Python SDK for the [apiz.ai](https://apiz.ai) AI generation platform.

> **Status: Phase 1B scaffolding.** Stub `Apiz` / `AsyncApiz` only. Real HTTP
> client, resources and helpers arrive in Phase 3B.

## Install

```bash
pip install apiz
```

## Usage (preview)

```python
from apiz import Apiz, AsyncApiz

# Sync
client = Apiz()  # reads APIZ_API_KEY from env
task = client.tasks.create(model="fal-ai/flux-2/flash", params={"prompt": "a cat"})
result = client.tasks.wait_for(task.task_id)

# Async
import asyncio

async def main():
    async with AsyncApiz() as client:
        out = await client.generate(
            model="wan/v2.6/image-to-video",
            prompt="camera zooms in",
            image_url="https://...",
        )

asyncio.run(main())
```

## Environment variables

| Var | Default | Purpose |
|---|---|---|
| `APIZ_API_KEY` | (none) | Bearer token. Get one at <https://www.xskill.ai/#/v2/api-keys> |
| `APIZ_BASE_URL` | `https://api.apiz.ai` | Override backend |
| `APIZ_TIMEOUT` | `60` | Per-request timeout in seconds |

The legacy `XSKILL_API_KEY` env var is also accepted.

## Development

```bash
uv venv
uv pip install -e ".[dev]"
uv run pytest                 # mock-only suite
uv run pytest -m e2e          # live backend (requires APIZ_TEST_API_KEY)
uv run ruff check .
uv run mypy src
```

## License

Apache-2.0
