Metadata-Version: 2.4
Name: kinoapi
Version: 0.1.0
Summary: Official Python SDK for Kino API — Seedance 2.0 video & Seedream 5.0 image generation
Author: Kino
License: MIT
Project-URL: Homepage, https://kino-api.com
Project-URL: Documentation, https://kino-api.com/docs.html
Keywords: seedance,seedream,video generation,image generation,ai api
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Multimedia :: Video
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# Kino API — official Python SDK

[![PyPI](https://img.shields.io/pypi/v/kinoapi.svg)](https://pypi.org/project/kinoapi/)

Unofficial-free, zero-dependency Python client for [Kino API](https://kino-api.com) —
official full-strength **Seedance 2.0 video** and **Seedream 5.0 image** generation.
Pure standard library, Python 3.8+.

```bash
pip install kinoapi
```

## Quickstart

```python
from kinoapi import KinoClient

kino = KinoClient("sk-YOUR_TOKEN")

# Video (async, ~30-90s, returns the finished video URL)
url = kino.generate_video(
    "seedance-2.0-mini",
    "Wind turbines on a green hillside at dawn, cinematic",
    duration=5,
    resolution="720p",   # 480p / 720p / 1080p / 4k (model-dependent)
    ratio="16:9",        # 16:9 / 9:16 / 1:1
)
print(url)

# Image (sync, ~30s, returns the image URL)
img = kino.generate_image("seedream-5.0-lite", "a tiny paper boat in a puddle")
print(img)
```

## Low-level API

```python
# Video is task-based — fine-grained control:
task = kino.create_video_task("seedance-2.0-mini", "a cat", duration=5,
                              resolution="480p")
print(task["task_id"])
state = kino.get_video_task(task["task_id"])
# state["data"]["status"] == "SUCCESS" -> state["data"]["result_url"]
```

## Pricing

- Video: per generated second (480p mini from $0.074/s; 1080p pro $0.550/s)
- Images: per successful image (lite $0.052, pro $0.132)
- Failed tasks refunded automatically. Balance never expires.

Full pricing & docs: https://kino-api.com/docs.html

## License

MIT
