seedream-cli 2026.3.17.0__py3-none-any.whl

seedream_cli/__init__.py

@@ -0,0 +1 @@
+"""Seedream CLI - AI Seedream Image Generation via AceDataCloud API."""

seedream_cli/__main__.py

@@ -0,0 +1,5 @@
+"""Allow running as python -m seedream_cli."""
+
+from seedream_cli.main import cli
+
+cli()

seedream_cli/commands/__init__.py

@@ -0,0 +1 @@
+"""Seedream CLI command modules."""

seedream_cli/commands/image.py

@@ -0,0 +1,123 @@
+"""Image generation commands."""
+
+import click
+
+from seedream_cli.core.client import get_client
+from seedream_cli.core.exceptions import SeedreamError
+from seedream_cli.core.output import (
+    SEEDREAM_MODELS, DEFAULT_MODEL, print_error, print_json, print_image_result, RESOLUTIONS, DEFAULT_RESOLUTION,
+)
+
+
+@click.command()
+@click.argument("prompt")
+@click.option(
+    "-m",
+    "--model",
+    type=click.Choice(SEEDREAM_MODELS),
+    default=DEFAULT_MODEL,
+    help="Seedream model version.",
+)
+@click.option(
+    "-r",
+    "--resolution",
+    type=click.Choice(RESOLUTIONS),
+    default=None,
+    help="Output resolution.",
+)
+@click.option("--callback-url", default=None, help="Webhook callback URL.")
+@click.option("--json", "output_json", is_flag=True, help="Output raw JSON.")
+@click.pass_context
+def generate(
+    ctx: click.Context,
+    prompt: str,
+    model: str,
+    resolution: str | None,
+    callback_url: str | None,
+    output_json: bool,
+) -> None:
+    """Generate an image from a text prompt.
+
+    PROMPT is a detailed description of what to generate.
+
+    Examples:
+
+      seedream generate "A beautiful landscape painting"
+
+      seedream generate "A product photo" -m doubao-seedream-4-5-251128
+    """
+    client = get_client(ctx.obj.get("token"))
+    try:
+        payload: dict[str, object] = {
+            "prompt": prompt,
+            "model": model,
+            "callback_url": callback_url,
+        }
+        if resolution:
+            payload["resolution"] = resolution
+
+        result = client.generate_image(**payload)  # type: ignore[arg-type]
+        if output_json:
+            print_json(result)
+        else:
+            print_image_result(result)
+    except SeedreamError as e:
+        print_error(e.message)
+        raise SystemExit(1) from e
+
+
+@click.command()
+@click.argument("prompt")
+@click.option(
+    "-i",
+    "--image-url",
+    "image_urls",
+    required=True,
+    multiple=True,
+    help="Image URL(s) to edit. Can be specified multiple times.",
+)
+@click.option(
+    "-m",
+    "--model",
+    type=click.Choice(SEEDREAM_MODELS),
+    default=DEFAULT_MODEL,
+    help="Seedream model version.",
+)
+@click.option("--callback-url", default=None, help="Webhook callback URL.")
+@click.option("--json", "output_json", is_flag=True, help="Output raw JSON.")
+@click.pass_context
+def edit(
+    ctx: click.Context,
+    prompt: str,
+    image_urls: tuple[str, ...],
+    model: str,
+    callback_url: str | None,
+    output_json: bool,
+) -> None:
+    """Edit or combine images using AI.
+
+    PROMPT describes the desired edit. Use with one or more image URLs.
+
+    Examples:
+
+      seedream edit "Convert to anime style" -i https://example.com/photo.jpg
+
+      seedream edit "Virtual try-on" -i person.jpg -i shirt.jpg
+    """
+    client = get_client(ctx.obj.get("token"))
+    try:
+        result = client.edit_image(
+            action="edit",
+            prompt=prompt,
+            image_urls=list(image_urls),
+            model=model,
+            callback_url=callback_url,
+        )
+        if output_json:
+            print_json(result)
+        else:
+            print_image_result(result)
+    except SeedreamError as e:
+        print_error(e.message)
+        raise SystemExit(1) from e
+

seedream_cli/commands/info.py

@@ -0,0 +1,48 @@
+"""Info and utility commands."""
+
+import click
+
+from seedream_cli.core.config import settings
+from seedream_cli.core.output import console, print_models
+from seedream_cli.core.output import RESOLUTIONS
+
+
+@click.command()
+def models() -> None:
+    """List available Seedream models."""
+    print_models()
+
+
+@click.command()
+def resolutions() -> None:
+    """List available output resolutions."""
+    from rich.table import Table
+
+    table = Table(title="Available Resolutions")
+    table.add_column("Resolution", style="bold cyan")
+    table.add_column("Description")
+
+    desc_map = {"480p": "Standard", "720p": "HD", "1080p": "Full HD", "1K": "Default", "2K": "High resolution", "4K": "Ultra-high resolution"}
+    for r in RESOLUTIONS:
+        table.add_row(r, desc_map.get(r, r))
+
+    console.print(table)
+
+
+@click.command()
+def config() -> None:
+    """Show current configuration."""
+    from rich.table import Table
+
+    table = Table(title="Seedream CLI Configuration")
+    table.add_column("Setting", style="bold cyan")
+    table.add_column("Value")
+
+    table.add_row("API Base URL", settings.api_base_url)
+    table.add_row(
+        "API Token", f"{settings.api_token[:8]}..." if settings.api_token else "[red]Not set[/red]"
+    )
+    table.add_row("Default Model", settings.default_model)
+    table.add_row("Request Timeout", f"{settings.request_timeout}s")
+
+    console.print(table)

seedream_cli/commands/task.py

@@ -0,0 +1,142 @@
+"""Task management commands."""
+
+import time
+
+import click
+
+from seedream_cli.core.client import get_client
+from seedream_cli.core.exceptions import SeedreamError
+from seedream_cli.core.output import print_error, print_json, print_success, print_task_result
+
+
+@click.command()
+@click.argument("task_id")
+@click.option("--json", "output_json", is_flag=True, help="Output raw JSON.")
+@click.pass_context
+def task(
+    ctx: click.Context,
+    task_id: str,
+    output_json: bool,
+) -> None:
+    """Query a single task status.
+
+    TASK_ID is the task ID returned from generate commands.
+
+    Examples:
+
+      seedream task abc123-def456
+    """
+    client = get_client(ctx.obj.get("token"))
+    try:
+        result = client.query_task(id=task_id, action="retrieve")
+        if output_json:
+            print_json(result)
+        else:
+            print_task_result(result)
+    except SeedreamError as e:
+        print_error(e.message)
+        raise SystemExit(1) from e
+
+
+@click.command("tasks")
+@click.argument("task_ids", nargs=-1, required=True)
+@click.option("--json", "output_json", is_flag=True, help="Output raw JSON.")
+@click.pass_context
+def tasks_batch(
+    ctx: click.Context,
+    task_ids: tuple[str, ...],
+    output_json: bool,
+) -> None:
+    """Query multiple tasks at once.
+
+    TASK_IDS are space-separated task IDs.
+
+    Examples:
+
+      seedream tasks abc123 def456 ghi789
+    """
+    client = get_client(ctx.obj.get("token"))
+    try:
+        result = client.query_task(ids=list(task_ids), action="retrieve_batch")
+        if output_json:
+            print_json(result)
+        else:
+            print_task_result(result)
+    except SeedreamError as e:
+        print_error(e.message)
+        raise SystemExit(1) from e
+
+
+@click.command()
+@click.argument("task_id")
+@click.option(
+    "--interval",
+    type=int,
+    default=5,
+    help="Polling interval in seconds (default: 5).",
+)
+@click.option(
+    "--timeout",
+    "max_timeout",
+    type=int,
+    default=600,
+    help="Maximum wait time in seconds (default: 600).",
+)
+@click.option("--json", "output_json", is_flag=True, help="Output raw JSON.")
+@click.pass_context
+def wait(
+    ctx: click.Context,
+    task_id: str,
+    interval: int,
+    max_timeout: int,
+    output_json: bool,
+) -> None:
+    """Wait for a task to complete, polling periodically.
+
+    TASK_ID is the task ID to monitor.
+
+    Examples:
+
+      seedream wait abc123
+
+      seedream wait abc123 --interval 10 --timeout 300
+    """
+    client = get_client(ctx.obj.get("token"))
+    elapsed = 0
+
+    try:
+        while elapsed < max_timeout:
+            result = client.query_task(id=task_id, action="retrieve")
+            data = result.get("data", {})
+
+            # Check completion - handle both list and dict responses
+            if isinstance(data, list) and data:
+                item = data[0]
+            elif isinstance(data, dict):
+                item = data
+            else:
+                item = {}
+
+            state = item.get("state", item.get("status", ""))
+            if state in ("succeeded", "completed", "complete", "failed", "error"):
+                if output_json:
+                    print_json(result)
+                else:
+                    if state in ("failed", "error"):
+                        print_error(f"Task {task_id} failed.")
+                    else:
+                        print_success(f"Task {task_id} completed!")
+                    print_task_result(result)
+                return
+
+            if not output_json:
+                click.echo(f"Status: {state or 'pending'} (waited {elapsed}s)...", err=True)
+
+            time.sleep(interval)
+            elapsed += interval
+
+        print_error(f"Timeout: task {task_id} did not complete within {max_timeout}s")
+        raise SystemExit(1)
+    except SeedreamError as e:
+        print_error(e.message)
+        raise SystemExit(1) from e

seedream_cli/core/__init__.py

@@ -0,0 +1 @@
+"""Seedream CLI core modules."""

seedream_cli/core/client.py

@@ -0,0 +1,111 @@
+"""HTTP client for Seedream API."""
+
+from typing import Any
+
+import httpx
+
+from seedream_cli.core.config import settings
+from seedream_cli.core.exceptions import (
+    SeedreamAPIError,
+    SeedreamAuthError,
+    SeedreamTimeoutError,
+)
+
+
+class SeedreamClient:
+    """HTTP client for AceDataCloud Seedream API."""
+
+    def __init__(self, api_token: str | None = None, base_url: str | None = None):
+        self.api_token = api_token if api_token is not None else settings.api_token
+        self.base_url = base_url or settings.api_base_url
+        self.timeout = settings.request_timeout
+
+    def _get_headers(self) -> dict[str, str]:
+        """Get request headers with authentication."""
+        if not self.api_token:
+            raise SeedreamAuthError("API token not configured")
+        return {
+            "accept": "application/json",
+            "authorization": f"Bearer {self.api_token}",
+            "content-type": "application/json",
+        }
+
+    def request(
+        self,
+        endpoint: str,
+        payload: dict[str, Any],
+        timeout: float | None = None,
+    ) -> dict[str, Any]:
+        """Make a POST request to the Seedream API.
+
+        Args:
+            endpoint: API endpoint path
+            payload: Request body as dictionary
+            timeout: Optional timeout override
+
+        Returns:
+            API response as dictionary
+        """
+        url = f"{self.base_url}{endpoint}"
+        request_timeout = timeout or self.timeout
+
+        # Remove None values from payload
+        payload = {k: v for k, v in payload.items() if v is not None}
+
+        with httpx.Client() as http_client:
+            try:
+                response = http_client.post(
+                    url,
+                    json=payload,
+                    headers=self._get_headers(),
+                    timeout=request_timeout,
+                )
+
+                if response.status_code == 401:
+                    raise SeedreamAuthError("Invalid API token")
+
+                if response.status_code == 403:
+                    raise SeedreamAuthError("Access denied. Check your API permissions.")
+
+                response.raise_for_status()
+                return response.json()  # type: ignore[no-any-return]
+
+            except httpx.TimeoutException as e:
+                raise SeedreamTimeoutError(
+                    f"Request to {endpoint} timed out after {request_timeout}s"
+                ) from e
+
+            except SeedreamAuthError:
+                raise
+
+            except httpx.HTTPStatusError as e:
+                raise SeedreamAPIError(
+                    message=e.response.text,
+                    code=f"http_{e.response.status_code}",
+                    status_code=e.response.status_code,
+                ) from e
+
+            except Exception as e:
+                if isinstance(e, (SeedreamAPIError, SeedreamTimeoutError)):
+                    raise
+                raise SeedreamAPIError(message=str(e)) from e
+
+    # Convenience methods
+    def generate_image(self, **kwargs: Any) -> dict[str, Any]:
+        """Generate image using the main endpoint."""
+        return self.request("/seedream/images", kwargs)
+
+    def edit_image(self, **kwargs: Any) -> dict[str, Any]:
+        """Edit an image using the main endpoint."""
+        return self.request("/seedream/images", kwargs)
+
+    def query_task(self, **kwargs: Any) -> dict[str, Any]:
+        """Query task status using the tasks endpoint."""
+        return self.request("/seedream/tasks", kwargs)
+
+
+def get_client(token: str | None = None) -> SeedreamClient:
+    """Get a SeedreamClient instance, optionally overriding the token."""
+    if token:
+        return SeedreamClient(api_token=token)
+    return SeedreamClient()

seedream_cli/core/config.py

@@ -0,0 +1,42 @@
+"""Configuration management for Seedream CLI."""
+
+import os
+from dataclasses import dataclass, field
+
+from dotenv import load_dotenv
+
+load_dotenv()
+
+
+@dataclass
+class Settings:
+    """Application settings loaded from environment variables."""
+
+    api_base_url: str = field(
+        default_factory=lambda: os.environ.get(
+            "ACEDATACLOUD_API_BASE_URL", "https://api.acedata.cloud"
+        )
+    )
+    api_token: str = field(default_factory=lambda: os.environ.get("ACEDATACLOUD_API_TOKEN", ""))
+    request_timeout: float = field(
+        default_factory=lambda: float(os.environ.get("SEEDREAM_REQUEST_TIMEOUT", "1800"))
+    )
+    default_model: str = field(
+        default_factory=lambda: os.environ.get("SEEDREAM_DEFAULT_MODEL", "doubao-seedream-4-0-250828")
+    )
+
+    @property
+    def is_configured(self) -> bool:
+        """Check if the API token is configured."""
+        return bool(self.api_token)
+
+    def validate(self) -> None:
+        """Validate configuration. Raises ValueError if API token is missing."""
+        if not self.api_token:
+            raise ValueError(
+                "API token not configured. "
+                "Set ACEDATACLOUD_API_TOKEN environment variable or use --token option."
+            )
+
+
+settings = Settings()

seedream_cli/core/exceptions.py

@@ -0,0 +1,37 @@
+"""Custom exceptions for Seedream CLI."""
+
+
+class SeedreamError(Exception):
+    """Base exception for Seedream CLI."""
+
+    def __init__(self, message: str, code: str = "unknown"):
+        self.message = message
+        self.code = code
+        super().__init__(message)
+
+
+class SeedreamAuthError(SeedreamError):
+    """Authentication error."""
+
+    def __init__(self, message: str = "Authentication failed"):
+        super().__init__(message, code="auth_error")
+
+
+class SeedreamAPIError(SeedreamError):
+    """API error with HTTP status code."""
+
+    def __init__(
+        self,
+        message: str = "API request failed",
+        code: str = "api_error",
+        status_code: int | None = None,
+    ):
+        self.status_code = status_code
+        super().__init__(message, code)
+
+
+class SeedreamTimeoutError(SeedreamError):
+    """Request timeout error."""
+
+    def __init__(self, message: str = "Request timed out"):
+        super().__init__(message, code="timeout_error")

seedream_cli/core/output.py

@@ -0,0 +1,140 @@
+"""Rich terminal output formatting for Seedream CLI."""
+
+import json
+from typing import Any
+
+from rich.console import Console
+from rich.panel import Panel
+from rich.table import Table
+
+console = Console()
+
+# Available models
+SEEDREAM_MODELS = [
+    "doubao-seedream-4-5-251128",
+    "doubao-seedream-4-0-250828",
+    "doubao-seedream-3-0-t2i-250415",
+    "doubao-seededit-3-0-i2i-250628",
+]
+
+DEFAULT_MODEL = "doubao-seedream-4-0-250828"
+
+# Available resolutions
+RESOLUTIONS = [
+    "1K",
+    "2K",
+    "4K",
+]
+
+DEFAULT_RESOLUTION = "1K"
+
+
+def print_json(data: Any) -> None:
+    """Print data as formatted JSON."""
+    console.print(json.dumps(data, indent=2, ensure_ascii=False))
+
+
+def print_error(message: str) -> None:
+    """Print an error message."""
+    console.print(f"[bold red]Error:[/bold red] {message}")
+
+
+def print_success(message: str) -> None:
+    """Print a success message."""
+    console.print(f"[bold green]✓[/bold green] {message}")
+
+
+def print_image_result(data: dict[str, Any]) -> None:
+    """Print image generation result in a rich format."""
+    task_id = data.get("task_id", "N/A")
+    trace_id = data.get("trace_id", "N/A")
+    items = data.get("data", [])
+
+    console.print(
+        Panel(
+            f"[bold]Task ID:[/bold] {task_id}\n[bold]Trace ID:[/bold] {trace_id}",
+            title="[bold green]Image Result[/bold green]",
+            border_style="green",
+        )
+    )
+
+    if not items:
+        console.print("[yellow]No data available yet. Use 'task' to check status.[/yellow]")
+        return
+
+    if isinstance(items, list):
+        for i, item in enumerate(items, 1):
+            table = Table(show_header=False, box=None, padding=(0, 2))
+            table.add_column("Field", style="bold cyan", width=15)
+            table.add_column("Value")
+            table.add_row("Image", f"#{i}")
+            if item.get("image_url"):
+                table.add_row("URL", item["image_url"])
+            if item.get("state"):
+                table.add_row("State", item["state"])
+            if item.get("model_name"):
+                table.add_row("Model", item["model_name"])
+            if item.get("created_at"):
+                table.add_row("Created", item["created_at"])
+            console.print(table)
+            console.print()
+
+
+def print_task_result(data: dict[str, Any]) -> None:
+    """Print task query result in a rich format."""
+    tasks = data.get("data", [])
+
+    if isinstance(tasks, list):
+        for task_data in tasks:
+            table = Table(show_header=False, box=None, padding=(0, 2))
+            table.add_column("Field", style="bold cyan", width=15)
+            table.add_column("Value")
+
+            for key in ["id", "status", "state", "image_url", "model_name", "created_at"]:
+                if task_data.get(key):
+                    table.add_row(key.replace("_", " ").title(), str(task_data[key]))
+
+            console.print(table)
+            console.print()
+    elif isinstance(tasks, dict):
+        table = Table(show_header=False, box=None, padding=(0, 2))
+        table.add_column("Field", style="bold cyan", width=15)
+        table.add_column("Value")
+
+        for key in ["id", "status", "state", "image_url", "model_name", "created_at"]:
+            if tasks.get(key):
+                table.add_row(key.replace("_", " ").title(), str(tasks[key]))
+
+        console.print(table)
+
+
+def print_models() -> None:
+    """Print available Seedream models."""
+    table = Table(title="Available Seedream Models")
+    table.add_column("Model", style="bold cyan")
+    table.add_column("Version", style="bold")
+    table.add_column("Notes")
+
+    table.add_row(
+        "doubao-seedream-4-5-251128",
+        "V4.5",
+        "Flagship model, best quality",
+    )
+    table.add_row(
+        "doubao-seedream-4-0-250828",
+        "V4.0",
+        "Standard quality (default)",
+    )
+    table.add_row(
+        "doubao-seedream-3-0-t2i-250415",
+        "V3.0 T2I",
+        "Text-to-image generation",
+    )
+    table.add_row(
+        "doubao-seededit-3-0-i2i-250628",
+        "V3.0 I2I",
+        "Image-to-image editing",
+    )
+
+    console.print(table)
+    console.print(f"\n[dim]Default model: {DEFAULT_MODEL}[/dim]")

seedream_cli/main.py

@@ -0,0 +1,70 @@
+#!/usr/bin/env python3
+"""
+Seedream CLI - AI Seedream Image Generation via AceDataCloud API.
+
+A command-line tool for generating AI images using Seedream
+through the AceDataCloud platform.
+"""
+
+from importlib import metadata
+
+import click
+from dotenv import load_dotenv
+
+from seedream_cli.commands.image import edit, generate
+from seedream_cli.commands.task import task, tasks_batch, wait
+from seedream_cli.commands.info import models, config, resolutions
+
+load_dotenv()
+
+
+def get_version() -> str:
+    """Get the package version."""
+    try:
+        return metadata.version("seedream-cli")
+    except metadata.PackageNotFoundError:
+        return "dev"
+
+
+@click.group()
+@click.version_option(version=get_version(), prog_name="seedream-cli")
+@click.option(
+    "--token",
+    envvar="ACEDATACLOUD_API_TOKEN",
+    help="API token (or set ACEDATACLOUD_API_TOKEN env var).",
+)
+@click.pass_context
+def cli(ctx: click.Context, token: str | None) -> None:
+    """Seedream CLI - AI Image Generation powered by AceDataCloud.
+
+    Generate AI images from the command line.
+
+    Get your API token at https://platform.acedata.cloud
+
+    \b
+    Examples:
+      seedream generate "A beautiful landscape painting"
+      seedream edit "Make it look like a painting" -i photo.jpg
+      seedream task abc123-def456
+      seedream wait abc123 --interval 5
+
+    Set your token:
+      export ACEDATACLOUD_API_TOKEN=your_token
+    """
+    ctx.ensure_object(dict)
+    ctx.obj["token"] = token
+
+
+# Register commands
+cli.add_command(generate)
+cli.add_command(edit)
+cli.add_command(task)
+cli.add_command(tasks_batch)
+cli.add_command(wait)
+cli.add_command(models)
+cli.add_command(config)
+cli.add_command(resolutions)
+
+
+if __name__ == "__main__":
+    cli()

seedream_cli-2026.3.17.0.dist-info/METADATA

@@ -0,0 +1,266 @@
+Metadata-Version: 2.1
+Name: seedream-cli
+Version: 2026.3.17.0
+Summary: CLI tool for Seedream AI Image Generation via AceDataCloud API
+Project-URL: Homepage, https://github.com/AceDataCloud/SeedreamCli
+Project-URL: Repository, https://github.com/AceDataCloud/SeedreamCli
+Project-URL: Issues, https://github.com/AceDataCloud/SeedreamCli/issues
+Project-URL: Changelog, https://github.com/AceDataCloud/SeedreamCli/blob/main/CHANGELOG.md
+Author-email: AceDataCloud <support@acedata.cloud>
+Maintainer-email: AceDataCloud <support@acedata.cloud>
+License: MIT
+License-File: LICENSE
+Keywords: acedata,ai,cli,command-line,generation,image,seedream
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT 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: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Requires-Dist: click>=8.1.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: rich>=13.0.0
+Provides-Extra: all
+Requires-Dist: seedream-cli[dev,release,test]; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10.0; extra == 'dev'
+Requires-Dist: pre-commit>=3.7.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Provides-Extra: release
+Requires-Dist: build>=1.2.0; extra == 'release'
+Requires-Dist: twine>=6.1.0; extra == 'release'
+Provides-Extra: test
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'test'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'test'
+Requires-Dist: pytest>=8.0.0; extra == 'test'
+Requires-Dist: respx>=0.21.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# Seedream CLI
+
+[![PyPI version](https://img.shields.io/pypi/v/seedream-cli.svg)](https://pypi.org/project/seedream-cli/)
+[![PyPI downloads](https://img.shields.io/pypi/dm/seedream-cli.svg)](https://pypi.org/project/seedream-cli/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![CI](https://github.com/AceDataCloud/SeedreamCli/actions/workflows/ci.yaml/badge.svg)](https://github.com/AceDataCloud/SeedreamCli/actions/workflows/ci.yaml)
+
+A command-line tool for AI image generation using [Seedream](https://platform.acedata.cloud/) through the [AceDataCloud API](https://platform.acedata.cloud/).
+
+Generate AI images directly from your terminal — no MCP client required.
+
+## Features
+
+- **Image Generation** — Generate images from text prompts with multiple models
+- **Image Editing** — Edit, combine, and transform images with AI
+- **Multiple Models** — doubao-seedream-4-5-251128, doubao-seedream-4-0-250828, doubao-seedream-3-0-t2i-250415, doubao-seededit-3-0-i2i-250628
+- **Task Management** — Query tasks, batch query, wait with polling
+- **Rich Output** — Beautiful terminal tables and panels via Rich
+- **JSON Mode** — Machine-readable output with `--json` for piping
+
+## Quick Start
+
+### 1. Get API Token
+
+Get your API token from [AceDataCloud Platform](https://platform.acedata.cloud/):
+
+1. Sign up or log in
+2. Navigate to the Seedream API page
+3. Click "Acquire" to get your token
+
+### 2. Install
+
+```bash
+# Install with pip
+pip install seedream-cli
+
+# Or with uv (recommended)
+uv pip install seedream-cli
+
+# Or from source
+git clone https://github.com/AceDataCloud/SeedreamCli.git
+cd SeedreamCli
+pip install -e .
+```
+
+### 3. Configure
+
+```bash
+# Set your API token
+export ACEDATACLOUD_API_TOKEN=your_token_here
+
+# Or use .env file
+cp .env.example .env
+# Edit .env with your token
+```
+
+### 4. Use
+
+```bash
+# Generate an image
+seedream generate "A test image"
+
+# Edit an image
+seedream edit "Make it look like a painting" -i https://example.com/photo.jpg
+
+# Check task status
+seedream task <task-id>
+
+# Wait for completion
+seedream wait <task-id> --interval 5
+
+# List available models
+seedream models
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `seedream generate <prompt>` | Generate an image from a text prompt |
+| `seedream edit <prompt> -i <url>...` | Edit or combine images using AI |
+| `seedream task <task_id>` | Query a single task status |
+| `seedream tasks <id1> <id2>...` | Query multiple tasks at once |
+| `seedream wait <task_id>` | Wait for task completion with polling |
+| `seedream models` | List available Seedream models |
+| `seedream config` | Show current configuration |
+| `seedream resolutions` | List available output resolutions |
+
+
+## Global Options
+
+```
+--token TEXT    API token (or set ACEDATACLOUD_API_TOKEN env var)
+--version       Show version
+--help          Show help message
+```
+
+Most commands support:
+
+```
+--json          Output raw JSON (for piping/scripting)
+--model TEXT    Seedream model version (default: doubao-seedream-4-0-250828)
+```
+
+## Available Models
+
+| Model | Version | Notes |
+|-------|---------|-------|
+| `doubao-seedream-4-5-251128` | V4.5 | Flagship model, best quality |
+| `doubao-seedream-4-0-250828` | V4.0 | Standard quality (default) |
+| `doubao-seedream-3-0-t2i-250415` | V3.0 T2I | Text-to-image generation |
+| `doubao-seededit-3-0-i2i-250628` | V3.0 I2I | Image-to-image editing |
+
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `ACEDATACLOUD_API_TOKEN` | API token from AceDataCloud | *Required* |
+| `ACEDATACLOUD_API_BASE_URL` | API base URL | `https://api.acedata.cloud` |
+| `SEEDREAM_DEFAULT_MODEL` | Default model | `doubao-seedream-4-0-250828` |
+| `SEEDREAM_REQUEST_TIMEOUT` | Timeout in seconds | `1800` |
+
+## Development
+
+### Setup Development Environment
+
+```bash
+git clone https://github.com/AceDataCloud/SeedreamCli.git
+cd SeedreamCli
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev,test]"
+```
+
+### Run Tests
+
+```bash
+pytest
+pytest --cov=seedream_cli
+pytest tests/test_integration.py -m integration
+```
+
+### Code Quality
+
+```bash
+ruff format .
+ruff check .
+mypy seedream_cli
+```
+
+## Docker
+
+```bash
+docker pull ghcr.io/acedatacloud/seedream-cli:latest
+docker run --rm -e ACEDATACLOUD_API_TOKEN=your_token \
+  ghcr.io/acedatacloud/seedream-cli generate "A test image"
+```
+
+## Project Structure
+
+```
+SeedreamCli/
+├── seedream_cli/                # Main package
+│   ├── __init__.py
+│   ├── __main__.py            # python -m seedream_cli entry point
+│   ├── main.py                # CLI entry point
+│   ├── core/                  # Core modules
+│   │   ├── client.py          # HTTP client for Seedream API
+│   │   ├── config.py          # Configuration management
+│   │   ├── exceptions.py      # Custom exceptions
+│   │   └── output.py          # Rich terminal formatting
+│   └── commands/              # CLI command groups
+│       ├── image.py           # Image generation commands
+│       ├── task.py            # Task management commands
+│       └── info.py            # Info & utility commands
+├── tests/                     # Test suite
+├── .github/workflows/         # CI/CD (lint, test, publish to PyPI)
+├── Dockerfile                 # Container image
+├── deploy/                    # Kubernetes deployment configs
+├── .env.example               # Environment template
+├── pyproject.toml             # Project configuration
+└── README.md
+```
+
+## Seedream CLI vs MCP Seedream
+
+| Feature | Seedream CLI | MCP Seedream |
+|---------|-----------|-----------|
+| Interface | Terminal commands | MCP protocol |
+| Usage | Direct shell, scripts, CI/CD | Claude, VS Code, MCP clients |
+| Output | Rich tables / JSON | Structured MCP responses |
+| Automation | Shell scripts, piping | AI agent workflows |
+| Install | `pip install seedream-cli` | `pip install mcp-seedream` |
+
+Both tools use the same AceDataCloud API and share the same API token.
+
+## Contributing
+
+Contributions are welcome! Please:
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing`)
+5. Open a Pull Request
+
+### Development Requirements
+
+- Python 3.10+
+- Dependencies: `pip install -e ".[all]"`
+- Lint: `ruff check . && ruff format --check .`
+- Test: `pytest`
+
+## License
+
+This project is licensed under the MIT License — see the [LICENSE](LICENSE) file for details.

seedream_cli-2026.3.17.0.dist-info/RECORD

@@ -0,0 +1,17 @@
+seedream_cli/__init__.py,sha256=5xdUANJJr9OW5WiBo4YPaUEJ2Ez1rNKvT-QnZGNDBkI,72
+seedream_cli/__main__.py,sha256=t0BOcDkNiauczAA1ew8OCLjuM1IBuf_Ci3UO4mlx6T0,89
+seedream_cli/main.py,sha256=4ZjqK5B81TPN48Thf4LdAONDhiApKGW3V5Evuj3j4Yk,1731
+seedream_cli/commands/__init__.py,sha256=MWNlas-BWL_-94n1vx3XTdE-iX4undsECbwSFfyzHsY,36
+seedream_cli/commands/image.py,sha256=zMcD3YRhlek0uVniUC-vqBP0lsYGLohnE99y5dl_YxY,3222
+seedream_cli/commands/info.py,sha256=-mlpRRjcweacTiFW_JFM6po08gb_skgPDoRqxUaqfNc,1394
+seedream_cli/commands/task.py,sha256=sFtQLjP_L5eziYdjGLYq3Z3NaeObRT39ksnbL3QOWHs,3877
+seedream_cli/core/__init__.py,sha256=zyGhr4_lJcLwZIZl7ChZVUroNiWnmKNuQ7DwfBqZVns,33
+seedream_cli/core/client.py,sha256=Ls4Q6xtBJ6KqNyaTLOBWxhKrrOa9pFOW67v5GNIkT9s,3732
+seedream_cli/core/config.py,sha256=1rQvWrwTtn_V66DvwBtTD4cQLbteHarqMzYEFKYWTug,1265
+seedream_cli/core/exceptions.py,sha256=IgmIepFLIfzwoUp5a5KcwmCAKozo9-CVgCb7B6ytEac,979
+seedream_cli/core/output.py,sha256=p4S9CHoEikPlIRryXc-7LVT2PMqsitsDiVY_uGSYLtc,4186
+seedream_cli-2026.3.17.0.dist-info/METADATA,sha256=nuWVxzDNqrb1329J8ysowvlDGmNzvOlfKVFp1llBcIo,8797
+seedream_cli-2026.3.17.0.dist-info/WHEEL,sha256=TJPnKdtrSue7xZ_AVGkp9YXcvDrobsjBds1du3Nx6dc,87
+seedream_cli-2026.3.17.0.dist-info/entry_points.txt,sha256=zVLkxIXbBE_IMWYQHnc06U9JAXnfhqsAV1W6zmjeYSg,88
+seedream_cli-2026.3.17.0.dist-info/licenses/LICENSE,sha256=bxZ4efJS6INmQdLVfyxLQXtLCEaj-ORFNew2MaGiZ8E,1069
+seedream_cli-2026.3.17.0.dist-info/RECORD,,

seedream_cli-2026.3.17.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.21.1
+Root-Is-Purelib: true
+Tag: py3-none-any

seedream_cli-2026.3.17.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+seedream = seedream_cli.main:cli
+seedream-cli = seedream_cli.main:cli

seedream_cli-2026.3.17.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AceDataCloud
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.