everypixel-cli 0.3.0__tar.gz → 0.4.1__tar.gz

{everypixel_cli-0.3.0 → everypixel_cli-0.4.1}/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [0.4.1] - 2026-10-08
+
+- Display estimated and billed generation costs, including chat responses.
+- Report observed queue time while waiting for tasks.
+
+## [0.4.0] - 2026-10-07
+
+- Add ElevenLabs speech synthesis and voice design.
+- Add saved voice creation, listing, deletion, and Qwen cloning by voice ID.
+
 ## [0.3.0] - 2026-09-18
 
 - Add GPT Image 2.5 Sunburst and quality selection for GPT Image models.

{everypixel_cli-0.3.0 → everypixel_cli-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: everypixel-cli
-Version: 0.3.0
+Version: 0.4.1
 Summary: Official command line interface for Everypixel API
 Project-URL: Homepage, https://labs.everypixel.com
 Project-URL: Repository, https://github.com/everypixel/everypixel-cli
@@ -263,9 +263,12 @@ They support 4K output. The default `seedvr2` supports up to 1440p, with a
 | `everypixel lipsync video` | Synchronize a video with an audio track |
 | `everypixel lipsync image` | Create a lipsync video from a still image and audio |
 | `everypixel audio transcribe` | Transcribe speech from an audio file |
-| `everypixel audio tts-create` | Create speech with a built-in speaker |
-| `everypixel audio tts-clone` | Create speech from a cloned voice sample |
-| `everypixel audio tts-voice` | Create speech with a character voice |
+| `everypixel audio tts-create` | Create speech with a Qwen preset or saved ElevenLabs voice |
+| `everypixel audio tts-clone` | Create Qwen speech from an audio sample or saved voice |
+| `everypixel audio tts-design` | Design voice previews from a description |
+| `everypixel audio tts-voice` | Save audio samples or a design preview as a voice |
+| `everypixel audio tts-voices` | List presets and saved voices |
+| `everypixel audio tts-delete` | Delete an owned saved voice |
 
 Lipsync supports 720p; the API checks source media dimensions and duration.
 
@@ -290,6 +293,25 @@ everypixel audio tts-create \
   --download ./outputs
 ```
 
+`tts-create` lets the API choose the model when `--model` is omitted.
+`tts-clone` and `tts-design` default to `--model qwen3`.
+`--speaker`, `--style`, `--language`, and `--seed` are Qwen controls; `--character` applies only to Qwen voice design.
+Qwen text is limited to 200 characters. ElevenLabs synthesis accepts up to
+2048 characters and requires `--voice-id`. Supported synthesis models are
+`eleven_v4`, `eleven_v4_turbo`, `eleven_v3`, `eleven_v3_conversational`,
+`eleven_multilingual_v2`, and `eleven_flash_v2_5`. ElevenLabs design uses
+`eleven_multilingual_ttv_v2` or `eleven_ttv_v3`, with 100–1000 characters of
+text and a 20–1000 character `--prompt`.
+
+Save a returned preview with `tts-voice --name "Narrator" --preview-id UUID`, or save local
+samples with `tts-voice --name "My voice" --provider elevenlabs --audio ./sample.wav`.
+`--audio` is repeatable for ElevenLabs; Qwen (`--provider labs`, the default)
+requires one sample. Saving returns a voice card immediately. Use its ID with
+`tts-create --model eleven_v3 --voice-id UUID --text "Hello"` or
+`tts-clone --voice-id UUID --text "Hello"`. List voices with
+`tts-voices --provider elevenlabs --offset 0 --limit 50`, and delete an owned
+voice with `tts-delete --voice-id UUID`.
+
 ### Chat
 
 ```bash
@@ -369,6 +391,12 @@ Passing `--download` always waits for a successful result before saving files:
 everypixel wait TASK_ID --download ./outputs
 ```
 
+`elapsed_sec` is total local waiting time; `queue_sec` estimates time until the
+first observed `STARTED` response.
+
+API costs are USD strings: `estimated_cost` for pending tasks and `billed_cost`
+for successful results and chat. Missing costs are omitted; `"0"` means no charge.
+
 A Bash automation example:
 
 ```bash

{everypixel_cli-0.3.0 → everypixel_cli-0.4.1}/README.md

@@ -229,9 +229,12 @@ They support 4K output. The default `seedvr2` supports up to 1440p, with a
 | `everypixel lipsync video` | Synchronize a video with an audio track |
 | `everypixel lipsync image` | Create a lipsync video from a still image and audio |
 | `everypixel audio transcribe` | Transcribe speech from an audio file |
-| `everypixel audio tts-create` | Create speech with a built-in speaker |
-| `everypixel audio tts-clone` | Create speech from a cloned voice sample |
-| `everypixel audio tts-voice` | Create speech with a character voice |
+| `everypixel audio tts-create` | Create speech with a Qwen preset or saved ElevenLabs voice |
+| `everypixel audio tts-clone` | Create Qwen speech from an audio sample or saved voice |
+| `everypixel audio tts-design` | Design voice previews from a description |
+| `everypixel audio tts-voice` | Save audio samples or a design preview as a voice |
+| `everypixel audio tts-voices` | List presets and saved voices |
+| `everypixel audio tts-delete` | Delete an owned saved voice |
 
 Lipsync supports 720p; the API checks source media dimensions and duration.
 
@@ -256,6 +259,25 @@ everypixel audio tts-create \
   --download ./outputs
 ```
 
+`tts-create` lets the API choose the model when `--model` is omitted.
+`tts-clone` and `tts-design` default to `--model qwen3`.
+`--speaker`, `--style`, `--language`, and `--seed` are Qwen controls; `--character` applies only to Qwen voice design.
+Qwen text is limited to 200 characters. ElevenLabs synthesis accepts up to
+2048 characters and requires `--voice-id`. Supported synthesis models are
+`eleven_v4`, `eleven_v4_turbo`, `eleven_v3`, `eleven_v3_conversational`,
+`eleven_multilingual_v2`, and `eleven_flash_v2_5`. ElevenLabs design uses
+`eleven_multilingual_ttv_v2` or `eleven_ttv_v3`, with 100–1000 characters of
+text and a 20–1000 character `--prompt`.
+
+Save a returned preview with `tts-voice --name "Narrator" --preview-id UUID`, or save local
+samples with `tts-voice --name "My voice" --provider elevenlabs --audio ./sample.wav`.
+`--audio` is repeatable for ElevenLabs; Qwen (`--provider labs`, the default)
+requires one sample. Saving returns a voice card immediately. Use its ID with
+`tts-create --model eleven_v3 --voice-id UUID --text "Hello"` or
+`tts-clone --voice-id UUID --text "Hello"`. List voices with
+`tts-voices --provider elevenlabs --offset 0 --limit 50`, and delete an owned
+voice with `tts-delete --voice-id UUID`.
+
 ### Chat
 
 ```bash
@@ -335,6 +357,12 @@ Passing `--download` always waits for a successful result before saving files:
 everypixel wait TASK_ID --download ./outputs
 ```
 
+`elapsed_sec` is total local waiting time; `queue_sec` estimates time until the
+first observed `STARTED` response.
+
+API costs are USD strings: `estimated_cost` for pending tasks and `billed_cost`
+for successful results and chat. Missing costs are omitted; `"0"` means no charge.
+
 A Bash automation example:
 
 ```bash

everypixel_cli-0.4.1/src/everypixel_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.4.1"

{everypixel_cli-0.3.0 → everypixel_cli-0.4.1}/src/everypixel_cli/application/serialization.py

@@ -14,6 +14,8 @@ def serialize_operation_result(result: OperationResult) -> Any:
     value = result.value
     if isinstance(value, Mapping):
         payload = dict(value)
+        if "task_id" in payload and payload.get("status") == "SUCCESS":
+            payload.pop("estimated_cost", None)
         if result.saved_files:
             payload["downloaded"] = [str(path) for path in result.saved_files]
         return payload

{everypixel_cli-0.3.0 → everypixel_cli-0.4.1}/src/everypixel_cli/application/services.py

@@ -34,6 +34,13 @@ from ..openapi import (
 )
 from ..schemas import (
     ChatRequest,
+    TTS_CREATE_PAYLOADS,
+    TTS_DESIGN_PAYLOADS,
+    TTSClonePayload,
+    TTSDefaultCreatePayload,
+    TTSVoiceSavePayload,
+    TTSVoicesPayload,
+    TTSVoiceDeletePayload,
     GPT_IMAGE_MODEL_QUALITIES,
     ImageEditPayload,
     ImageGeneratePayload,
@@ -205,14 +212,20 @@ class TaskService:
 
     def wait(self, task_id: str, options: ExecutionOptions) -> dict[str, Any]:
         started = time.monotonic()
+        queue_sec: float | None = None
         while True:
             options.check_cancelled()
             payload = self.status(task_id)
             options.check_cancelled()
+            elapsed = time.monotonic() - started
+            if payload.get("status") == "STARTED" and queue_sec is None:
+                queue_sec = round(elapsed, 2)
             if payload.get("status") == "SUCCESS":
-                payload["elapsed_sec"] = round(time.monotonic() - started, 2)
+                payload["elapsed_sec"] = round(elapsed, 2)
+                if queue_sec is not None:
+                    payload["queue_sec"] = queue_sec
                 return payload
-            if time.monotonic() - started >= options.timeout:
+            if elapsed >= options.timeout:
                 raise TaskPollingError(
                     f"Timed out waiting for task {task_id}",
                     code="timeout",
@@ -240,11 +253,14 @@ class OperationService:
     def execute(self, request: OperationRequest) -> OperationResult:
         method = request.method.upper()
         payload = dict(request.payload)
+        use_query = method == "GET" or (
+            method == "DELETE" and request.endpoint == "/v1/tts_voice"
+        )
         response = self.client.request(
             method,
             request.endpoint,
-            json=payload if method != "GET" else None,
-            params=payload if method == "GET" else None,
+            json=None if use_query else payload,
+            params=payload if use_query else None,
         )
         if not isinstance(response, Mapping) or "task_id" not in response:
             return OperationResult(value=response)
@@ -753,33 +769,64 @@ def read_text_input(text: str | None, text_file: Path | None) -> str:
     return text
 
 
-def build_tts_create_payload(**values: Any) -> dict[str, Any]:
-    """Build a text-to-speech creation request."""
+def validate_tts_payload(
+    path: str, values: dict[str, Any], *, generic: bool = False
+) -> BaseModel:
+    """Select a provider schema without dropping unsupported controls."""
+    if generic:
+        schemas: list[type[BaseModel]] = [
+            *TTS_CREATE_PAYLOADS.values(),
+            *TTS_DESIGN_PAYLOADS.values(),
+            TTSClonePayload,
+            TTSDefaultCreatePayload,
+        ]
+        known_fields = {field for schema in schemas for field in schema.model_fields}
+        values = {key: value for key, value in values.items() if key in known_fields}
+    if path == "/v1/tts_create" and "model" not in values:
+        return TTSDefaultCreatePayload.model_validate(values)
+    registries = {
+        "/v1/tts_create": TTS_CREATE_PAYLOADS,
+        "/v1/tts_design": TTS_DESIGN_PAYLOADS,
+    }
+    if path in registries:
+        model = values.get("model", "qwen3")
+        schema = registries[path].get(model) if isinstance(model, str) else None
+        if schema is None:
+            raise ValidationCLIError("Unsupported TTS model")
+        return schema.model_validate(values)
+    return TTSClonePayload.model_validate(values)
+
 
+def _build_tts_payload(path: str, values: dict[str, Any]) -> dict[str, Any]:
     text = values.pop("text")
     text_file = values.pop("text_file")
-    return {"text": read_text_input(text, text_file), **values}
+    values = {key: value for key, value in values.items() if value is not None}
+    values["text"] = read_text_input(text, text_file)
+    return validate_tts_payload(path, values).model_dump(mode="json", exclude_none=True)
 
 
-def build_tts_voice_payload(**values: Any) -> dict[str, Any]:
-    """Build a character voice text-to-speech request."""
+def build_tts_create_payload(**values: Any) -> dict[str, Any]:
+    return _build_tts_payload("/v1/tts_create", values)
 
-    text = values.pop("text")
-    text_file = values.pop("text_file")
-    return {"text": read_text_input(text, text_file), **values}
+
+def build_tts_design_payload(**values: Any) -> dict[str, Any]:
+    return _build_tts_payload("/v1/tts_design", values)
 
 
 def build_tts_clone_payload(**values: Any) -> dict[str, Any]:
-    """Build a cloned-voice text-to-speech request."""
+    audio = values.pop("audio")
+    if audio is not None:
+        values["audio_url"] = media_value(audio)
+    return _build_tts_payload("/v1/tts_clone", values)
+
 
+def build_tts_voice_payload(**values: Any) -> dict[str, Any]:
     audio = values.pop("audio")
-    text = values.pop("text")
-    text_file = values.pop("text_file")
-    return {
-        "audio_url": media_value(audio),
-        "text": read_text_input(text, text_file),
-        **values,
-    }
+    if audio:
+        values["audio_urls"] = [media_value(sample) for sample in audio]
+    return TTSVoiceSavePayload.model_validate(
+        {key: value for key, value in values.items() if value is not None}
+    ).model_dump(mode="json", exclude_none=True)
 
 
 @dataclass
@@ -1147,25 +1194,28 @@ class ApplicationServices:
         *,
         text: str | None,
         text_file: Path | None,
-        speaker: str,
-        style: str,
-        language: str,
-        prompt: str,
-        seed: int,
         execution: ExecutionOptions,
+        model: str | None = None,
+        voice_id: str | None = None,
+        speaker: str | None = None,
+        style: str | None = None,
+        language: str | None = None,
+        prompt: str | None = None,
+        seed: int | None = None,
     ) -> OperationResult:
-        payload = build_tts_create_payload(
-            text=text,
-            text_file=text_file,
-            speaker=speaker,
-            style=style,
-            language=language,
-            prompt=prompt,
-            seed=seed,
-        )
         return self._execute_async(
             endpoint="/v1/tts_create",
-            payload=payload,
+            payload=build_tts_create_payload(
+                text=text,
+                text_file=text_file,
+                model=model,
+                voice_id=voice_id,
+                speaker=speaker,
+                style=style,
+                language=language,
+                prompt=prompt,
+                seed=seed,
+            ),
             execution=execution,
             fallback_extension=".mp3",
         )
@@ -1173,55 +1223,113 @@ class ApplicationServices:
     def execute_tts_clone(
         self,
         *,
-        audio: str,
         text: str | None,
         text_file: Path | None,
-        language: str,
-        seed: int,
         execution: ExecutionOptions,
+        audio: str | None = None,
+        voice_id: str | None = None,
+        model: str = "qwen3",
+        language: str | None = None,
+        seed: int | None = None,
     ) -> OperationResult:
-        payload = build_tts_clone_payload(
-            audio=audio,
-            text=text,
-            text_file=text_file,
-            language=language,
-            seed=seed,
-        )
         return self._execute_async(
             endpoint="/v1/tts_clone",
-            payload=payload,
+            payload=build_tts_clone_payload(
+                audio=audio,
+                text=text,
+                text_file=text_file,
+                voice_id=voice_id,
+                model=model,
+                language=language,
+                seed=seed,
+            ),
             execution=execution,
             fallback_extension=".mp3",
         )
 
-    def execute_tts_voice(
+    def execute_tts_design(
         self,
         *,
         text: str | None,
         text_file: Path | None,
-        character: str,
-        style: str,
-        language: str,
-        prompt: str,
-        seed: int,
         execution: ExecutionOptions,
+        model: str = "qwen3",
+        character: str | None = None,
+        style: str | None = None,
+        language: str | None = None,
+        prompt: str | None = None,
+        seed: int | None = None,
     ) -> OperationResult:
-        payload = build_tts_voice_payload(
-            text=text,
-            text_file=text_file,
-            character=character,
-            style=style,
-            language=language,
-            prompt=prompt,
-            seed=seed,
-        )
         return self._execute_async(
-            endpoint="/v1/tts_voice",
-            payload=payload,
+            endpoint="/v1/tts_design",
+            payload=build_tts_design_payload(
+                text=text,
+                text_file=text_file,
+                model=model,
+                character=character,
+                style=style,
+                language=language,
+                prompt=prompt,
+                seed=seed,
+            ),
             execution=execution,
             fallback_extension=".mp3",
         )
 
+    def execute_tts_voice(
+        self,
+        *,
+        name: str,
+        audio: list[str],
+        provider: str | None = None,
+        preview_id: str | None = None,
+        description: str = "",
+    ) -> OperationResult:
+        return self._operations.execute(
+            OperationRequest(
+                endpoint="/v1/tts_voice",
+                method="POST",
+                payload=build_tts_voice_payload(
+                    name=name,
+                    audio=audio,
+                    provider=provider,
+                    preview_id=preview_id,
+                    description=description,
+                ),
+                execution=ExecutionOptions(),
+            )
+        )
+
+    def list_tts_voices(
+        self,
+        *,
+        provider: str = "labs",
+        offset: int = 0,
+        limit: int = 50,
+    ) -> OperationResult:
+        return self._operations.execute(
+            OperationRequest(
+                endpoint="/v1/tts_voices",
+                method="GET",
+                payload=TTSVoicesPayload.model_validate(
+                    {"provider": provider, "offset": offset, "limit": limit}
+                ).model_dump(),
+                execution=ExecutionOptions(),
+            )
+        )
+
+    def delete_tts_voice(self, *, voice_id: str) -> OperationResult:
+        return self._operations.execute(
+            OperationRequest(
+                endpoint="/v1/tts_voice",
+                method="DELETE",
+                payload=TTSVoiceDeletePayload.model_validate(
+                    {"voice_id": voice_id}
+                ).model_dump(mode="json"),
+                execution=ExecutionOptions(),
+            )
+        )
+
     def execute_chat(
         self,
         *,
@@ -1340,6 +1448,19 @@ class ApplicationServices:
             _VIDEO_EDIT_ADAPTER.validate_python(payload, extra="ignore")
         if path == "/v1/chat/completions":
             ChatRequest.model_validate(payload, extra="ignore")
+        if resolved_method == "POST" and path in {
+            "/v1/tts_create",
+            "/v1/tts_clone",
+            "/v1/tts_design",
+        }:
+            validate_tts_payload(path, payload, generic=True)
+        if path == "/v1/tts_voice":
+            if resolved_method == "POST":
+                TTSVoiceSavePayload.model_validate(payload)
+            elif resolved_method == "DELETE":
+                TTSVoiceDeletePayload.model_validate(payload)
+        if path == "/v1/tts_voices" and resolved_method == "GET":
+            TTSVoicesPayload.model_validate(payload)
         validate_payload_against_operation(operation, payload)
         if dry_run:
             return OperationResult(

{everypixel_cli-0.3.0 → everypixel_cli-0.4.1}/src/everypixel_cli/cli.py

@@ -1285,17 +1285,19 @@ def tts_create(
     ctx: typer.Context,
     text: Annotated[Optional[str], typer.Option("--text")] = None,
     text_file: Annotated[Optional[Path], typer.Option("--text-file")] = None,
-    speaker: str = "Ryan",
-    style: str = "Auto",
-    language: str = "Auto",
-    prompt: str = "",
-    seed: int = -1,
+    model: Optional[str] = None,
+    voice_id: Optional[str] = None,
+    speaker: Optional[str] = None,
+    style: Optional[str] = None,
+    language: Optional[str] = None,
+    prompt: Optional[str] = None,
+    seed: Optional[int] = None,
     wait_option: WaitOption = None,
     download: DownloadOption = None,
     output_json: OutputJsonOption = False,
     jq_expr: JqOption = None,
 ) -> None:
-    """Create speech from text using a selected speaker."""
+    """Create speech using Qwen presets or a saved ElevenLabs voice."""
 
     runtime = apply_common_options(
         ctx,
@@ -1309,6 +1311,8 @@ def tts_create(
         lambda: runtime.services().execute_tts_create(
             text=text,
             text_file=text_file,
+            model=model,
+            voice_id=voice_id,
             speaker=speaker,
             style=style,
             language=language,
@@ -1322,11 +1326,13 @@ def tts_create(
 @audio_app.command("tts-clone")
 def tts_clone(
     ctx: typer.Context,
-    audio: Annotated[str, typer.Option("--audio")],
+    audio: Annotated[Optional[str], typer.Option("--audio")] = None,
+    voice_id: Optional[str] = None,
     text: Annotated[Optional[str], typer.Option("--text")] = None,
     text_file: Annotated[Optional[Path], typer.Option("--text-file")] = None,
-    language: str = "Auto",
-    seed: int = -1,
+    model: str = "qwen3",
+    language: Optional[str] = None,
+    seed: Optional[int] = None,
     wait_option: WaitOption = None,
     download: DownloadOption = None,
     output_json: OutputJsonOption = False,
@@ -1345,8 +1351,10 @@ def tts_clone(
         ctx,
         lambda: runtime.services().execute_tts_clone(
             audio=audio,
+            voice_id=voice_id,
             text=text,
             text_file=text_file,
+            model=model,
             language=language,
             seed=seed,
             execution=runtime.execution_options(),
@@ -1354,22 +1362,23 @@ def tts_clone(
     )
 
 
-@audio_app.command("tts-voice")
-def tts_voice(
+@audio_app.command("tts-design")
+def tts_design(
     ctx: typer.Context,
     text: Annotated[Optional[str], typer.Option("--text")] = None,
     text_file: Annotated[Optional[Path], typer.Option("--text-file")] = None,
-    character: str = "Female",
-    style: str = "Auto",
-    language: str = "Auto",
-    prompt: str = "",
-    seed: int = -1,
+    model: str = "qwen3",
+    character: Optional[str] = None,
+    style: Optional[str] = None,
+    language: Optional[str] = None,
+    prompt: Optional[str] = None,
+    seed: Optional[int] = None,
     wait_option: WaitOption = None,
     download: DownloadOption = None,
     output_json: OutputJsonOption = False,
     jq_expr: JqOption = None,
 ) -> None:
-    """Create speech from text using a character voice."""
+    """Design voice previews from a description."""
 
     runtime = apply_common_options(
         ctx,
@@ -1380,9 +1389,10 @@ def tts_voice(
     )
     run_action(
         ctx,
-        lambda: runtime.services().execute_tts_voice(
+        lambda: runtime.services().execute_tts_design(
             text=text,
             text_file=text_file,
+            model=model,
             character=character,
             style=style,
             language=language,
@@ -1393,6 +1403,64 @@ def tts_voice(
     )
 
 
+@audio_app.command("tts-voice")
+def tts_voice(
+    ctx: typer.Context,
+    name: Annotated[str, typer.Option("--name")],
+    audio: Annotated[list[str], typer.Option("--audio")] = [],
+    provider: Optional[str] = None,
+    preview_id: Optional[str] = None,
+    description: str = "",
+    output_json: OutputJsonOption = False,
+    jq_expr: JqOption = None,
+) -> None:
+    """Save a voice from audio samples or a design preview."""
+    runtime = apply_common_options(ctx, output_json=output_json, jq_expr=jq_expr)
+    run_action(
+        ctx,
+        lambda: runtime.services().execute_tts_voice(
+            name=name,
+            audio=audio,
+            provider=provider,
+            preview_id=preview_id,
+            description=description,
+        ),
+    )
+
+
+@audio_app.command("tts-voices")
+def tts_voices(
+    ctx: typer.Context,
+    provider: str = "labs",
+    offset: int = 0,
+    limit: int = 50,
+    output_json: OutputJsonOption = False,
+    jq_expr: JqOption = None,
+) -> None:
+    """List presets and saved voices for a provider."""
+    runtime = apply_common_options(ctx, output_json=output_json, jq_expr=jq_expr)
+    run_action(
+        ctx,
+        lambda: runtime.services().list_tts_voices(
+            provider=provider,
+            offset=offset,
+            limit=limit,
+        ),
+    )
+
+
+@audio_app.command("tts-delete")
+def tts_delete(
+    ctx: typer.Context,
+    voice_id: Annotated[str, typer.Option("--voice-id")],
+    output_json: OutputJsonOption = False,
+    jq_expr: JqOption = None,
+) -> None:
+    """Delete an owned saved voice."""
+    runtime = apply_common_options(ctx, output_json=output_json, jq_expr=jq_expr)
+    run_action(ctx, lambda: runtime.services().delete_tts_voice(voice_id=voice_id))
+
+
 @app.command("status")
 def status(
     ctx: typer.Context,