everypixel-cli 0.5.0__tar.gz → 0.5.1__tar.gz

{everypixel_cli-0.5.0 → everypixel_cli-0.5.1}/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## [0.5.1] - 2026-10-28
+
+- Add account balance lookup and request cost estimation with `--estimate-cost`.
+- Support Seedance generation with first/last frames or reference images.
+
 ## [0.5.0] - 2026-10-12
 
 - Add FLUX.3 images, Nano Banana 2.1, Nano Banana 2 Lite, and Seedream 5 Flash.

{everypixel_cli-0.5.0 → everypixel_cli-0.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: everypixel-cli
-Version: 0.5.0
+Version: 0.5.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
@@ -137,6 +137,26 @@ CLI falls back to its user configuration file when a keyring is unavailable;
 
 ## Commands
 
+### Balance and cost estimates
+
+`everypixel balance` shows the account balance in USD and the owner's email.
+The balance is settled; recent usage may not yet be reflected.
+
+Add `--estimate-cost` to image, video, lipsync, transcription, or speech generation
+commands to estimate the request's USD cost without creating a task or consuming
+quota. Estimates include available free quota and personal rates; they do not
+reserve funds. Task polling and downloads are skipped for estimate responses.
+
+```bash
+everypixel balance --output-json
+everypixel image generate "a lake" --estimate-cost
+everypixel run image_generate --input prompt="a lake" --estimate-cost --output-json
+```
+
+`run --estimate-cost` supports the same API operations, including background
+removal, video matting, and video soundtrack generation. Chat, classic analysis,
+and saved voice management endpoints do not support cost estimation.
+
 ### Images
 
 | Command | Description |
@@ -234,7 +254,9 @@ Input options depend on the model:
 - `first-last` accepts `--image` and `--last-image` for models that support frame pairs.
 - MiniMax and WAN 3.0 accept repeatable reference options, separately from frame inputs.
   Use `--reference-image`, `--reference-video`, and, for MiniMax, `--reference-audio`.
-- Gemini Omni generation accepts frame images or `--reference-image`, separately.
+- Gemini Omni and Seedance generation accept frame images or `--reference-image`, separately.
+  Use `--model seedance2`, `seedance2-mini`, or `seedance2.5` with `from-image` or
+  `first-last`. Seedance 2.5 derives the aspect ratio from the first frame.
 - Grok Imagine 1.5 (`grok-imagine-1.5`) requires `--image` and supports 1080p.
 - Aleph 2 accepts repeatable `--keyframe` JSON; inspect `video edit --help` for its fields.
 

{everypixel_cli-0.5.0 → everypixel_cli-0.5.1}/README.md

@@ -103,6 +103,26 @@ CLI falls back to its user configuration file when a keyring is unavailable;
 
 ## Commands
 
+### Balance and cost estimates
+
+`everypixel balance` shows the account balance in USD and the owner's email.
+The balance is settled; recent usage may not yet be reflected.
+
+Add `--estimate-cost` to image, video, lipsync, transcription, or speech generation
+commands to estimate the request's USD cost without creating a task or consuming
+quota. Estimates include available free quota and personal rates; they do not
+reserve funds. Task polling and downloads are skipped for estimate responses.
+
+```bash
+everypixel balance --output-json
+everypixel image generate "a lake" --estimate-cost
+everypixel run image_generate --input prompt="a lake" --estimate-cost --output-json
+```
+
+`run --estimate-cost` supports the same API operations, including background
+removal, video matting, and video soundtrack generation. Chat, classic analysis,
+and saved voice management endpoints do not support cost estimation.
+
 ### Images
 
 | Command | Description |
@@ -200,7 +220,9 @@ Input options depend on the model:
 - `first-last` accepts `--image` and `--last-image` for models that support frame pairs.
 - MiniMax and WAN 3.0 accept repeatable reference options, separately from frame inputs.
   Use `--reference-image`, `--reference-video`, and, for MiniMax, `--reference-audio`.
-- Gemini Omni generation accepts frame images or `--reference-image`, separately.
+- Gemini Omni and Seedance generation accept frame images or `--reference-image`, separately.
+  Use `--model seedance2`, `seedance2-mini`, or `seedance2.5` with `from-image` or
+  `first-last`. Seedance 2.5 derives the aspect ratio from the first frame.
 - Grok Imagine 1.5 (`grok-imagine-1.5`) requires `--image` and supports 1080p.
 - Aleph 2 accepts repeatable `--keyframe` JSON; inspect `video edit --help` for its fields.
 

everypixel_cli-0.5.1/src/everypixel_cli/__init__.py

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

{everypixel_cli-0.5.0 → everypixel_cli-0.5.1}/src/everypixel_cli/application/models.py

@@ -26,6 +26,8 @@ class ExecutionOptions:
         compare=False,
     )
 
+    estimate_cost: bool = False
+
     @property
     def wait_for_result(self) -> bool:
         """Downloads always require a completed task."""

{everypixel_cli-0.5.0 → everypixel_cli-0.5.1}/src/everypixel_cli/application/services.py

@@ -66,6 +66,43 @@ from .models import (
 )
 
 
+COST_ESTIMATE_ENDPOINTS = frozenset(
+    f"/v1/{name}"
+    for name in (
+        "image_vectorize",
+        "image_generate",
+        "image_upscale",
+        "image_remove_background",
+        "image_edit",
+        "image_edit_angles",
+        "image_edit_colors",
+        "video_lipsync",
+        "image_lipsync",
+        "video_generate",
+        "video_edit",
+        "video_upscale",
+        "video_matting",
+        "video_soundtrack",
+        "tts_design",
+        "tts_clone",
+        "tts_create",
+        "transcribe",
+    )
+)
+
+
+def estimate_cost_params(
+    endpoint: str, method: str, execution: ExecutionOptions
+) -> dict[str, Any]:
+    """Keep the quote flag in the query and reject unsupported operations."""
+
+    if not execution.estimate_cost:
+        return {}
+    if method.upper() != "POST" or endpoint not in COST_ESTIMATE_ENDPOINTS:
+        raise ValidationCLIError("estimate_cost is not supported for this endpoint")
+    return {"estimate_cost": 1}
+
+
 _VIDEO_GENERATE_ADAPTER: TypeAdapter[VideoGenerateRequest] = TypeAdapter(
     VideoGenerateRequest
 )
@@ -256,11 +293,14 @@ class OperationService:
         use_query = method == "GET" or (
             method == "DELETE" and request.endpoint == "/v1/tts_voice"
         )
+        params = estimate_cost_params(request.endpoint, method, request.execution)
+        if use_query:
+            params.update(payload)
         response = self.client.request(
             method,
             request.endpoint,
             json=None if use_query else payload,
-            params=payload if use_query else None,
+            params=params or None,
         )
         if not isinstance(response, Mapping) or "task_id" not in response:
             return OperationResult(value=response)
@@ -687,6 +727,30 @@ def build_image_upscale_payload(**values: Any) -> dict[str, Any]:
     ).model_dump(exclude_none=True)
 
 
+def _build_seedance_video_generate_payload(payload: dict[str, Any]) -> dict[str, Any]:
+    """Translate CLI frame and reference options into Seedance image content."""
+
+    content = []
+    for key, role in (("image_url", "first_frame"), ("image_last_url", "last_frame")):
+        url = payload.pop(key, None)
+        if url is not None:
+            content.append(
+                {"type": "image_url", "role": role, "image_url": {"url": url}}
+            )
+    for url in payload.pop("reference_image_urls", []):
+        content.append(
+            {"type": "image_url", "role": "reference_image", "image_url": {"url": url}}
+        )
+    return {**payload, "content": content}
+
+
+_VIDEO_GENERATE_BUILDERS = {
+    "seedance2": _build_seedance_video_generate_payload,
+    "seedance2-mini": _build_seedance_video_generate_payload,
+    "seedance2.5": _build_seedance_video_generate_payload,
+}
+
+
 def build_video_generate_payload(**values: Any) -> dict[str, Any]:
     """Build text/image video generation payloads with typed model validation."""
 
@@ -725,6 +789,10 @@ def build_video_generate_payload(**values: Any) -> dict[str, Any]:
         payload["reference_audio_urls"] = [
             media_value(value) for value in reference_audios
         ]
+    model = payload.get("model")
+    builder = _VIDEO_GENERATE_BUILDERS.get(model) if isinstance(model, str) else None
+    if builder is not None:
+        payload = builder(payload)
     validated = _VIDEO_GENERATE_ADAPTER.validate_python(
         {key: value for key, value in payload.items() if value is not None}
     )
@@ -1498,12 +1566,14 @@ class ApplicationServices:
         if path == "/v1/tts_voices" and resolved_method == "GET":
             TTSVoicesPayload.model_validate(payload)
         validate_payload_against_operation(operation, payload)
+        params = estimate_cost_params(path, resolved_method, execution)
         if dry_run:
             return OperationResult(
                 value={
                     "method": resolved_method,
                     "path": path,
                     "body": payload,
+                    **({"params": params} if params else {}),
                     "headers": {
                         "Authorization": "Basic ***" if client_id_present else None
                     },
@@ -1586,6 +1656,13 @@ class ApplicationServices:
     def execute_video_keywords(self, *, video: str) -> OperationResult:
         return self._execute_classic(path="/v1/video_keywords", media=video)
 
+    def get_balance(self) -> OperationResult:
+        """Return the authenticated owner's settled USD balance."""
+
+        return self._operations.execute(
+            OperationRequest(endpoint="/v1/account/balance", method="GET", payload={})
+        )
+
     def check_auth(self) -> OperationResult:
         """Run an authentication check without a CLI dependency."""
 

{everypixel_cli-0.5.0 → everypixel_cli-0.5.1}/src/everypixel_cli/cli.py

@@ -162,6 +162,10 @@ def positive_float(value: float) -> float:
 WaitOption = Annotated[
     Optional[bool], typer.Option("--wait/--no-wait", help="Override wait mode.")
 ]
+EstimateCostOption = Annotated[
+    bool,
+    typer.Option("--estimate-cost", help="Estimate USD cost without creating a task."),
+]
 DownloadOption = Annotated[
     Optional[Path],
     typer.Option("--download", "-d", help="Download result URLs into a directory."),
@@ -190,6 +194,7 @@ class Runtime:
     download: Path | None
     no_color: bool
     debug: bool
+    estimate_cost: bool = False
     _services: ApplicationServices | None = field(
         default=None,
         init=False,
@@ -223,6 +228,7 @@ class Runtime:
 
         return ExecutionOptions(
             wait=self.wait if wait is None else wait,
+            estimate_cost=self.estimate_cost,
             download_directory=self.download,
             timeout=self.timeout,
             poll_interval=self.poll_interval,
@@ -424,10 +430,13 @@ def apply_common_options(
     download: Path | None = None,
     output_json: bool = False,
     jq_expr: str | None = None,
+    estimate_cost: bool = False,
 ) -> Runtime:
     """Apply command-local common flags on top of global runtime settings."""
 
     runtime = get_runtime(ctx)
+    if estimate_cost:
+        runtime.estimate_cost = True
     if output_json or jq_expr is not None:
         runtime.output_json = True
     if jq_expr is not None:
@@ -679,6 +688,7 @@ def image_generate(
     ] = None,
     seed: Annotated[int, typer.Option("--seed")] = -1,
     callback_url: Annotated[Optional[str], typer.Option("--callback-url")] = None,
+    estimate_cost: EstimateCostOption = False,
     wait_option: WaitOption = None,
     download: DownloadOption = None,
     output_json: OutputJsonOption = False,
@@ -688,6 +698,7 @@ def image_generate(
 
     runtime = apply_common_options(
         ctx,
+        estimate_cost=estimate_cost,
         wait_option=wait_option,
         download=download,
         output_json=output_json,
@@ -733,6 +744,7 @@ def image_edit(
     ] = None,
     seed: Annotated[int, typer.Option("--seed")] = -1,
     callback_url: Annotated[Optional[str], typer.Option("--callback-url")] = None,
+    estimate_cost: EstimateCostOption = False,
     wait_option: WaitOption = None,
     download: DownloadOption = None,
     output_json: OutputJsonOption = False,
@@ -742,6 +754,7 @@ def image_edit(
 
     runtime = apply_common_options(
         ctx,
+        estimate_cost=estimate_cost,
         wait_option=wait_option,
         download=download,
         output_json=output_json,
@@ -769,6 +782,7 @@ def image_vectorize(
     ctx: typer.Context,
     image: Annotated[str, typer.Argument(help="Image URL or local path.")],
     callback_url: Annotated[Optional[str], typer.Option("--callback-url")] = None,
+    estimate_cost: EstimateCostOption = False,
     wait_option: WaitOption = None,
     download: DownloadOption = None,
     output_json: OutputJsonOption = False,
@@ -778,6 +792,7 @@ def image_vectorize(
 
     runtime = apply_common_options(
         ctx,
+        estimate_cost=estimate_cost,
         wait_option=wait_option,
         download=download,
         output_json=output_json,
@@ -800,6 +815,7 @@ def image_upscale(
     task_id: Annotated[Optional[str], typer.Option("--task-id")] = None,
     model: Annotated[str, typer.Option("--model")] = "seedvr2",
     callback_url: Annotated[Optional[str], typer.Option("--callback-url")] = None,
+    estimate_cost: EstimateCostOption = False,
     wait_option: WaitOption = None,
     download: DownloadOption = None,
     output_json: OutputJsonOption = False,
@@ -809,6 +825,7 @@ def image_upscale(
 
     runtime = apply_common_options(
         ctx,
+        estimate_cost=estimate_cost,
         wait_option=wait_option,
         download=download,
         output_json=output_json,
@@ -834,6 +851,7 @@ def image_angles(
     elevation: str = "eye_level",
     distance: str = "medium",
     prompt: Optional[str] = None,
+    estimate_cost: EstimateCostOption = False,
     wait_option: WaitOption = None,
     download: DownloadOption = None,
     output_json: OutputJsonOption = False,
@@ -843,6 +861,7 @@ def image_angles(
 
     runtime = apply_common_options(
         ctx,
+        estimate_cost=estimate_cost,
         wait_option=wait_option,
         download=download,
         output_json=output_json,
@@ -866,6 +885,7 @@ def image_colors(
     ctx: typer.Context,
     image: Annotated[str, typer.Option("--image")],
     reference: Annotated[str, typer.Option("--reference")],
+    estimate_cost: EstimateCostOption = False,
     wait_option: WaitOption = None,
     download: DownloadOption = None,
     output_json: OutputJsonOption = False,
@@ -875,6 +895,7 @@ def image_colors(
 
     runtime = apply_common_options(
         ctx,
+        estimate_cost=estimate_cost,
         wait_option=wait_option,
         download=download,
         output_json=output_json,
@@ -902,7 +923,10 @@ def video_generate(
         list[str],
         typer.Option(
             "--reference-image",
-            help="MiniMax, Wan or Omni reference image URL/path. Can be repeated.",
+            help=(
+                "MiniMax, Wan, Omni or Seedance reference image URL/path. "
+                "Can be repeated."
+            ),
         ),
     ] = [],
     reference_video: Annotated[
@@ -924,6 +948,7 @@ def video_generate(
         Optional[bool], typer.Option("--generate-audio/--no-generate-audio")
     ] = None,
     callback_url: Annotated[Optional[str], typer.Option("--callback-url")] = None,
+    estimate_cost: EstimateCostOption = False,
     wait_option: WaitOption = None,
     download: DownloadOption = None,
     output_json: OutputJsonOption = False,
@@ -933,6 +958,7 @@ def video_generate(
 
     runtime = apply_common_options(
         ctx,
+        estimate_cost=estimate_cost,
         wait_option=wait_option,
         download=download,
         output_json=output_json,
@@ -1002,6 +1028,7 @@ def video_edit(
         Optional[bool], typer.Option("--generate-audio/--no-generate-audio")
     ] = None,
     callback_url: Annotated[Optional[str], typer.Option("--callback-url")] = None,
+    estimate_cost: EstimateCostOption = False,
     wait_option: WaitOption = None,
     download: DownloadOption = None,
     output_json: OutputJsonOption = False,
@@ -1011,6 +1038,7 @@ def video_edit(
 
     runtime = apply_common_options(
         ctx,
+        estimate_cost=estimate_cost,
         wait_option=wait_option,
         download=download,
         output_json=output_json,
@@ -1052,6 +1080,7 @@ def video_from_image(
         Optional[bool], typer.Option("--generate-audio/--no-generate-audio")
     ] = None,
     callback_url: Annotated[Optional[str], typer.Option("--callback-url")] = None,
+    estimate_cost: EstimateCostOption = False,
     wait_option: WaitOption = None,
     download: DownloadOption = None,
     output_json: OutputJsonOption = False,
@@ -1061,6 +1090,7 @@ def video_from_image(
 
     runtime = apply_common_options(
         ctx,
+        estimate_cost=estimate_cost,
         wait_option=wait_option,
         download=download,
         output_json=output_json,
@@ -1098,6 +1128,7 @@ def video_first_last(
         Optional[bool], typer.Option("--generate-audio/--no-generate-audio")
     ] = None,
     callback_url: Annotated[Optional[str], typer.Option("--callback-url")] = None,
+    estimate_cost: EstimateCostOption = False,
     wait_option: WaitOption = None,
     download: DownloadOption = None,
     output_json: OutputJsonOption = False,
@@ -1107,6 +1138,7 @@ def video_first_last(
 
     runtime = apply_common_options(
         ctx,
+        estimate_cost=estimate_cost,
         wait_option=wait_option,
         download=download,
         output_json=output_json,
@@ -1147,6 +1179,7 @@ def video_upscale(
             ),
         ),
     ] = "1080p",
+    estimate_cost: EstimateCostOption = False,
     wait_option: WaitOption = None,
     download: DownloadOption = None,
     output_json: OutputJsonOption = False,
@@ -1160,6 +1193,7 @@ def video_upscale(
 
     runtime = apply_common_options(
         ctx,
+        estimate_cost=estimate_cost,
         wait_option=wait_option,
         download=download,
         output_json=output_json,
@@ -1187,6 +1221,7 @@ def lipsync_video(
     prompt: Optional[str] = None,
     seed: int = -1,
     callback_url: Annotated[Optional[str], typer.Option("--callback-url")] = None,
+    estimate_cost: EstimateCostOption = False,
     wait_option: WaitOption = None,
     download: DownloadOption = None,
     output_json: OutputJsonOption = False,
@@ -1196,6 +1231,7 @@ def lipsync_video(
 
     runtime = apply_common_options(
         ctx,
+        estimate_cost=estimate_cost,
         wait_option=wait_option,
         download=download,
         output_json=output_json,
@@ -1225,6 +1261,7 @@ def lipsync_image(
     prompt: Optional[str] = None,
     seed: int = -1,
     callback_url: Annotated[Optional[str], typer.Option("--callback-url")] = None,
+    estimate_cost: EstimateCostOption = False,
     wait_option: WaitOption = None,
     download: DownloadOption = None,
     output_json: OutputJsonOption = False,
@@ -1234,6 +1271,7 @@ def lipsync_image(
 
     runtime = apply_common_options(
         ctx,
+        estimate_cost=estimate_cost,
         wait_option=wait_option,
         download=download,
         output_json=output_json,
@@ -1261,6 +1299,7 @@ def audio_transcribe(
     language: str = "auto",
     hints: str = "",
     denoise: bool = True,
+    estimate_cost: EstimateCostOption = False,
     wait_option: WaitOption = None,
     download: DownloadOption = None,
     output_json: OutputJsonOption = False,
@@ -1270,6 +1309,7 @@ def audio_transcribe(
 
     runtime = apply_common_options(
         ctx,
+        estimate_cost=estimate_cost,
         wait_option=wait_option,
         download=download,
         output_json=output_json,
@@ -1299,6 +1339,7 @@ def tts_create(
     language: Optional[str] = None,
     prompt: Optional[str] = None,
     seed: Optional[int] = None,
+    estimate_cost: EstimateCostOption = False,
     wait_option: WaitOption = None,
     download: DownloadOption = None,
     output_json: OutputJsonOption = False,
@@ -1308,6 +1349,7 @@ def tts_create(
 
     runtime = apply_common_options(
         ctx,
+        estimate_cost=estimate_cost,
         wait_option=wait_option,
         download=download,
         output_json=output_json,
@@ -1340,6 +1382,7 @@ def tts_clone(
     model: str = "qwen3",
     language: Optional[str] = None,
     seed: Optional[int] = None,
+    estimate_cost: EstimateCostOption = False,
     wait_option: WaitOption = None,
     download: DownloadOption = None,
     output_json: OutputJsonOption = False,
@@ -1349,6 +1392,7 @@ def tts_clone(
 
     runtime = apply_common_options(
         ctx,
+        estimate_cost=estimate_cost,
         wait_option=wait_option,
         download=download,
         output_json=output_json,
@@ -1380,6 +1424,7 @@ def tts_design(
     language: Optional[str] = None,
     prompt: Optional[str] = None,
     seed: Optional[int] = None,
+    estimate_cost: EstimateCostOption = False,
     wait_option: WaitOption = None,
     download: DownloadOption = None,
     output_json: OutputJsonOption = False,
@@ -1389,6 +1434,7 @@ def tts_design(
 
     runtime = apply_common_options(
         ctx,
+        estimate_cost=estimate_cost,
         wait_option=wait_option,
         download=download,
         output_json=output_json,
@@ -1468,6 +1514,18 @@ def tts_delete(
     run_action(ctx, lambda: runtime.services().delete_tts_voice(voice_id=voice_id))
 
 
+@app.command("balance")
+def balance(
+    ctx: typer.Context,
+    output_json: OutputJsonOption = False,
+    jq_expr: JqOption = None,
+) -> None:
+    """Show the account balance in USD and the owner's email."""
+
+    runtime = apply_common_options(ctx, output_json=output_json, jq_expr=jq_expr)
+    run_action(ctx, lambda: runtime.services().get_balance())
+
+
 @app.command("status")
 def status(
     ctx: typer.Context,
@@ -1631,6 +1689,7 @@ def generic_run(
     method: Annotated[Optional[str], typer.Option("--method")] = None,
     dry_run: Annotated[bool, typer.Option("--dry-run")] = False,
     help_schema: Annotated[bool, typer.Option("--help-schema")] = False,
+    estimate_cost: EstimateCostOption = False,
     wait_option: WaitOption = None,
     download: DownloadOption = None,
     output_json: OutputJsonOption = False,
@@ -1640,6 +1699,7 @@ def generic_run(
 
     runtime = apply_common_options(
         ctx,
+        estimate_cost=estimate_cost,
         wait_option=wait_option,
         download=download,
         output_json=output_json,