Metadata-Version: 2.4
Name: deepzeka-clearvoice
Version: 0.1.1
Summary: Official Python client for the Clear Voice audio restoration API
Author-email: Muhammed Emin KORKUT <destek@clearvoice.com.tr>
Maintainer-email: Muhammed Emin KORKUT <emin.korkut@deepzeka.com>
License-Expression: MIT
Project-URL: Homepage, https://clearvoice.com.tr
Project-URL: Documentation, https://clearvoice.com.tr/api
Project-URL: Repository, https://github.com/Eminkorkut/deepzeka-clearvoice
Project-URL: Issues, https://github.com/Eminkorkut/deepzeka-clearvoice/issues
Project-URL: LinkedIn, https://www.linkedin.com/in/muhammedeminkorkut
Keywords: clearvoice,audio,noise-reduction,speech-enhancement,api
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
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 :: Multimedia :: Sound/Audio
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx<1,>=0.24
Provides-Extra: dev
Requires-Dist: build>=1.2; extra == "dev"
Requires-Dist: pytest>=8; extra == "dev"
Requires-Dist: pytest-cov>=5; extra == "dev"
Requires-Dist: ruff>=0.6; extra == "dev"
Dynamic: license-file

# DeepZeka Clear Voice Python SDK

[Clear Voice](https://clearvoice.com.tr) REST API için Python istemcisi. Ses
dosyalarını yükler, asenkron işleri takip eder ve temizlenmiş sonucu indirir.

- PyPI paketi: `deepzeka-clearvoice`
- Python modülü: `clearvoice`
- Python 3.9 ve üzeri sürümlerle uyumludur.

## Kurulum

```bash
pip install deepzeka-clearvoice
```

## Hızlı başlangıç

```python
from clearvoice import ClearVoice

client = ClearVoice("cv_live_your_api_key_here")

job = client.create_job(
    "kayit.wav",
    model="V3",
    enhance_speech=True,
    normalize_volume=True,
)
print(job.id, job.status)

completed_job = client.wait_for_job(job.id)
output = client.download_result(completed_job.id, "temiz-kayit.mp3")
print(output)
```

Tüm akış tek çağrıyla da çalıştırılabilir:

```python
from clearvoice import ClearVoice, Model

with ClearVoice("cv_live_your_api_key_here") as client:
    output = client.process(
        "kayit.wav",
        "temiz-kayit.wav",
        model=Model.V4,
        format="wav",
        timeout=600,
    )
```

Anahtar kod içinde tutulmak istenmiyorsa `CLEARVOICE_API_KEY` ortam değişkenine
yazılabilir ve `ClearVoice()` parametresiz oluşturulabilir.

## Kullanım ve bakiye

```python
usage = client.get_usage()
print(usage.to_dict())
```

## Webhook doğrulama

İmzayı JSON'a dönüştürülmemiş özgün istek gövdesiyle doğrulayın:

```python
from clearvoice import verify_webhook_signature

valid = verify_webhook_signature(
    raw_request_body,
    request.headers["X-ClearVoice-Signature"],
    "whsec_your_webhook_signing_secret",
)
```

## Hata yönetimi

```python
from clearvoice import AuthenticationError, ClearVoice, RateLimitError

try:
    client = ClearVoice("cv_live_...")
    job = client.create_job("kayit.wav")
except AuthenticationError:
    print("API anahtarı geçersiz")
except RateLimitError:
    print("İstek limiti aşıldı")
```

## Geliştirme

Kaynak kodu klonlayıp geliştirme bağımlılıklarıyla kurmak için:

```bash
git clone https://github.com/Eminkorkut/deepzeka-clearvoice.git
cd deepzeka-clearvoice
python -m pip install -e ".[dev]"
pytest
ruff check .
python -m build
```

## Destek

API veya SDK ile ilgili sorular için [destek@clearvoice.com.tr](mailto:destek@clearvoice.com.tr)
adresine ulaşabilirsiniz.

## Geliştirici

**Muhammed Emin KORKUT**

- [LinkedIn](https://www.linkedin.com/in/muhammedeminkorkut)
- [GitHub](https://github.com/Eminkorkut)

## Lisans

Bu proje [MIT Lisansı](LICENSE) ile lisanslanmıştır.
