Metadata-Version: 2.4
Name: swarmauri_tts_deepinfra_qwen3
Version: 0.1.0a1
Summary: Alpha Swarmauri Deepinfra Qwen3 text-to-speech provider with native JSON audio, async synthesis and bounded batches; live API verification pending.
License-Expression: Apache-2.0
License-File: LICENSE
License-File: NOTICE
Keywords: swarmauri,deepinfra_qwen3,tts,text-to-speech,speech-synthesis,json-audio,async-audio,alpha-provider
Author: Jacob Stewart
Author-email: jacob@swarmauri.com
Requires-Python: >=3.10,<3.15
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 :: 3
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: Programming Language :: Python :: 3.14
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
Requires-Dist: httpx (>=0.27,<0.29)
Requires-Dist: pydantic (>=2.0)
Requires-Dist: swarmauri_base (>=0.11.0.dev12,<0.12)
Project-URL: Issues, https://github.com/swarmauri/swarmauri-sdk/issues
Project-URL: Repository, https://github.com/swarmauri/swarmauri-sdk
Description-Content-Type: text/markdown

![Swarmauri Logo](https://github.com/swarmauri/swarmauri-sdk/blob/3d4d1cfa949399d7019ae9d8f296afba773dfb7f/assets/swarmauri.brand.theme.svg)

# swarmauri_tts_deepinfra_qwen3

Alpha Swarmauri DeepInfraQwen3TTS component. Native Qwen3 input/voice/instruct schema, separate from Kokoro and voice design.

[![Downloads](https://img.shields.io/pypi/dm/swarmauri_tts_deepinfra_qwen3)](https://pepy.tech/projects/swarmauri_tts_deepinfra_qwen3)
[![Hits](https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/standards/swarmauri_tts_deepinfra_qwen3.svg)](https://github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/standards/swarmauri_tts_deepinfra_qwen3)
[![Python](https://img.shields.io/pypi/pyversions/swarmauri_tts_deepinfra_qwen3)](https://pypi.org/project/swarmauri_tts_deepinfra_qwen3/)
[![License](https://img.shields.io/pypi/l/swarmauri_tts_deepinfra_qwen3)](https://pypi.org/project/swarmauri_tts_deepinfra_qwen3/)
[![Version](https://img.shields.io/pypi/v/swarmauri_tts_deepinfra_qwen3?label=swarmauri_tts_deepinfra_qwen3&color=green)](https://pypi.org/project/swarmauri_tts_deepinfra_qwen3/)

## Features

- File synthesis, async synthesis and bounded batches from JSON-encoded audio.
- Provider-specific schemas and local input validation.
- Fixed provider endpoints and no automatic replay of billable requests.
- Python 3.10-3.14; no swarmauri_standard dependency.

## Installation

```bash
uv add --prerelease allow swarmauri_tts_deepinfra_qwen3
```

```bash
pip install --pre swarmauri_tts_deepinfra_qwen3
```

This source candidate needs swarmauri_base>=0.11.0.dev12 published first.

## Usage

```python
import os
from swarmauri_tts_deepinfra_qwen3 import DeepInfraQwen3TTS

provider = DeepInfraQwen3TTS(
    api_key=os.environ["DEEPINFRA_API_KEY"],
    voice="Vivian", language="English", instruct="Calm and clear",
)
path = provider.predict("Welcome to Swarmauri.", "welcome.wav")
# await provider.apredict(text, audio_path)
# provider.batch({"Hello": "hello.wav"})
# await provider.abatch({"Hello": "hello.wav"}, max_concurrent=2)
```

## API boundary

File responses must contain successful inference status (when reported) and
base64 audio or an audio data URI. URLs are rejected and never downloaded.
The reported output format must match the request. WAV responses need a RIFF/WAVE
header; no transcoding is performed. response_format supports wav (default),
mp3, opus, flac and pcm. Select matching file extensions. The component can be
used with TextToSpeechAgent; set its output_path to match the codec.

stream/astream raise NotImplementedError locally, before an API call. Catalog
streaming claims alone do not establish native framing or codec semantics.
No complete JSON response is presented as an incremental stream. Webhooks,
voice creation/deletion, reference uploads and account management are excluded.
Qwen3 uses input, voice, language, optional instruct and response_format; text is limited to 4000 characters. Preset names and already-provisioned voice IDs are accepted; voice creation is not implemented.

Primary reference: [provider API](https://deepinfra.com/Qwen/Qwen3-TTS/api).

## Verification and alpha status

Live API behavior is **unverified**; tracked in [#6306](https://github.com/swarmauri/swarmauri-sdk/issues/6306). No paid synthesis was run. Retain version
0.1.0a1 and Development Status :: 3 - Alpha until maintainers review sufficient
live evidence. Mocked schemas do not prove playable audio, model availability,
voice controls, quality, latency or cost.

Live tests require SWARMAURI_LIVE_TTS=1 plus private DEEPINFRA_API_KEY. Configure SWARMAURI_TTS_VOICE
for your account. Select the model with SWARMAURI_TTS_MODEL. A key alone never
enables the suite. Default selection is predict only (one billable request).
SWARMAURI_LIVE_TTS_OPERATIONS selects a comma-separated operation list.
The four supported operations make six billable requests per model. Streaming tests stay skipped. Never paste credentials or unmasked headers into issues or logs.
See the [verification tracker](https://github.com/swarmauri/swarmauri-sdk/blob/master/docs/verification/tts-providers.md).

## License

Apache-2.0. Part of the [Swarmauri SDK](https://github.com/swarmauri/swarmauri-sdk).

