openai-pro-cli 2026.8.11.0__tar.gz

openai_pro_cli-2026.8.11.0/.env.example

@@ -0,0 +1,9 @@
+# AceDataCloud API Token
+# Get yours at https://platform.acedata.cloud
+ACEDATACLOUD_API_TOKEN=
+
+# Optional: Custom API base URL (default: https://api.acedata.cloud)
+# ACEDATACLOUD_API_BASE_URL=https://api.acedata.cloud
+
+# Optional: Request timeout in seconds (default: 30)
+# OPENAI_REQUEST_TIMEOUT=30

openai_pro_cli-2026.8.11.0/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.2.0] - 2026-04-30
+
+### Added
+- `chat` command: new options `--max-completion-tokens`, `--top-p`, `--frequency-penalty`, `--presence-penalty`, `--seed`, `--stop`, `--reasoning-effort`, `--user`, `--service-tier`
+- `edit` command: new options `--mask-url`, `--partial-images`
+- `response` command: new options `--count` (`-n`), `--response-format`
+
+## [0.1.0] - 2025-04-25
+
+### Added
+- Initial release
+- `chat` command for OpenAI-compatible chat completions
+- `embed` command for text embeddings
+- `image` command for image generation
+- `edit` command for image editing
+- `response` command for Responses API
+- `models` info command listing available models
+- `config` command to inspect current settings

openai_pro_cli-2026.8.11.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 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.

openai_pro_cli-2026.8.11.0/PKG-INFO

@@ -0,0 +1,144 @@
+Metadata-Version: 2.1
+Name: openai-pro-cli
+Version: 2026.8.11.0
+Summary: CLI tool for OpenAI-compatible APIs via AceDataCloud
+Project-URL: Homepage, https://github.com/AceDataCloud/OpenAICli
+Project-URL: Repository, https://github.com/AceDataCloud/OpenAICli
+Project-URL: Issues, https://github.com/AceDataCloud/OpenAICli/issues
+Project-URL: Changelog, https://github.com/AceDataCloud/OpenAICli/blob/main/CHANGELOG.md
+Author-email: AceDataCloud <support@acedata.cloud>
+Maintainer-email: AceDataCloud <support@acedata.cloud>
+License: MIT
+License-File: LICENSE
+Keywords: acedata,chat,cli,command-line,embeddings,gpt,image-generation,openai
+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 :: 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: openai-pro-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
+
+# OpenAI CLI
+
+A command-line tool for OpenAI-compatible APIs via [AceDataCloud](https://platform.acedata.cloud).
+
+## Installation
+
+```bash
+pip install openai-pro-cli
+```
+
+## Quick Start
+
+### 1. Get an API Token
+
+Sign up at [https://platform.acedata.cloud](https://platform.acedata.cloud) and get your API token.
+
+### 2. Configure
+
+```bash
+export ACEDATACLOUD_API_TOKEN=your_token_here
+```
+
+Or save it to a `.env` file:
+
+```bash
+cp .env.example .env
+# Edit .env and set ACEDATACLOUD_API_TOKEN
+```
+
+### 3. Use
+
+```bash
+# Chat with a model
+openai-cli chat "What is the capital of France?"
+
+# Chat with a specific model
+openai-cli chat "Explain quantum computing" -m gpt-5.4
+
+# Generate embeddings
+openai-cli embed "Hello, world!" -m text-embedding-3-small
+
+# Generate an image
+openai-cli image "A futuristic city skyline at night"
+
+# Edit an image
+openai-cli edit "Add a rainbow" --image-url https://example.com/photo.jpg
+
+# Use the Responses API
+openai-cli response "Summarize this article" -m gpt-4o
+
+# Synthesize speech audio
+openai-cli speech "Hello from AceDataCloud" --voice nova --output hello.mp3
+
+# Show realtime WebSocket connection details
+openai-cli realtime --model gpt-realtime
+
+# Retrieve an async task result
+openai-cli tasks retrieve --id 7489df4c-ef03-4de0-b598-e9a590793434
+openai-cli tasks retrieve --trace-id my-custom-trace-001
+
+# Retrieve a batch of task results
+openai-cli tasks batch --trace-ids trace-001 trace-002
+
+# List available models
+openai-cli models
+
+# Show configuration
+openai-cli config
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `chat` | Chat completions (`/openai/chat/completions`) |
+| `embed` | Text embeddings (`/openai/embeddings`) |
+| `image` | Image generation (`/openai/images/generations`) |
+| `edit` | Image editing (`/openai/images/edits`) |
+| `response` | Responses API (`/openai/responses`) |
+| `speech` | Speech synthesis (`/v1/audio/speech`) |
+| `realtime` | Realtime WebSocket connection info (`/v1/realtime`) |
+| `tasks retrieve` | Retrieve a single async task result (`/openai/tasks`) |
+| `tasks batch` | Retrieve multiple async task results (`/openai/tasks`) |
+| `models` | List available models (`/openai/models`) |
+| `config` | Show current configuration |
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `ACEDATACLOUD_API_TOKEN` | Your API token (required) | — |
+| `ACEDATACLOUD_API_BASE_URL` | API base URL | `https://api.acedata.cloud` |
+| `OPENAI_REQUEST_TIMEOUT` | Request timeout in seconds | `30` |
+
+## Docker
+
+```bash
+docker compose run --rm openai-cli chat "Hello!" -m gpt-4o
+```

openai_pro_cli-2026.8.11.0/README.md

@@ -0,0 +1,99 @@
+# OpenAI CLI
+
+A command-line tool for OpenAI-compatible APIs via [AceDataCloud](https://platform.acedata.cloud).
+
+## Installation
+
+```bash
+pip install openai-pro-cli
+```
+
+## Quick Start
+
+### 1. Get an API Token
+
+Sign up at [https://platform.acedata.cloud](https://platform.acedata.cloud) and get your API token.
+
+### 2. Configure
+
+```bash
+export ACEDATACLOUD_API_TOKEN=your_token_here
+```
+
+Or save it to a `.env` file:
+
+```bash
+cp .env.example .env
+# Edit .env and set ACEDATACLOUD_API_TOKEN
+```
+
+### 3. Use
+
+```bash
+# Chat with a model
+openai-cli chat "What is the capital of France?"
+
+# Chat with a specific model
+openai-cli chat "Explain quantum computing" -m gpt-5.4
+
+# Generate embeddings
+openai-cli embed "Hello, world!" -m text-embedding-3-small
+
+# Generate an image
+openai-cli image "A futuristic city skyline at night"
+
+# Edit an image
+openai-cli edit "Add a rainbow" --image-url https://example.com/photo.jpg
+
+# Use the Responses API
+openai-cli response "Summarize this article" -m gpt-4o
+
+# Synthesize speech audio
+openai-cli speech "Hello from AceDataCloud" --voice nova --output hello.mp3
+
+# Show realtime WebSocket connection details
+openai-cli realtime --model gpt-realtime
+
+# Retrieve an async task result
+openai-cli tasks retrieve --id 7489df4c-ef03-4de0-b598-e9a590793434
+openai-cli tasks retrieve --trace-id my-custom-trace-001
+
+# Retrieve a batch of task results
+openai-cli tasks batch --trace-ids trace-001 trace-002
+
+# List available models
+openai-cli models
+
+# Show configuration
+openai-cli config
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `chat` | Chat completions (`/openai/chat/completions`) |
+| `embed` | Text embeddings (`/openai/embeddings`) |
+| `image` | Image generation (`/openai/images/generations`) |
+| `edit` | Image editing (`/openai/images/edits`) |
+| `response` | Responses API (`/openai/responses`) |
+| `speech` | Speech synthesis (`/v1/audio/speech`) |
+| `realtime` | Realtime WebSocket connection info (`/v1/realtime`) |
+| `tasks retrieve` | Retrieve a single async task result (`/openai/tasks`) |
+| `tasks batch` | Retrieve multiple async task results (`/openai/tasks`) |
+| `models` | List available models (`/openai/models`) |
+| `config` | Show current configuration |
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `ACEDATACLOUD_API_TOKEN` | Your API token (required) | — |
+| `ACEDATACLOUD_API_BASE_URL` | API base URL | `https://api.acedata.cloud` |
+| `OPENAI_REQUEST_TIMEOUT` | Request timeout in seconds | `30` |
+
+## Docker
+
+```bash
+docker compose run --rm openai-cli chat "Hello!" -m gpt-4o
+```

openai_pro_cli-2026.8.11.0/openai_cli/__init__.py

@@ -0,0 +1,3 @@
+"""OpenAI CLI - Command-line tool for OpenAI-compatible APIs via AceDataCloud."""
+
+__version__ = "0.1.0"

openai_pro_cli-2026.8.11.0/openai_cli/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for running as a module: python -m openai_cli."""
+
+from openai_cli.main import cli
+
+if __name__ == "__main__":
+    cli()

openai_pro_cli-2026.8.11.0/openai_cli/commands/__init__.py

@@ -0,0 +1 @@
+"""OpenAI CLI commands package."""

openai_pro_cli-2026.8.11.0/openai_cli/commands/_json.py

@@ -0,0 +1,46 @@
+"""Helpers for parsing JSON-valued CLI options."""
+
+import json
+from typing import Any
+
+import click
+
+
+def parse_json_value(value: str | None, option_name: str) -> Any:
+    """Parse a CLI option as JSON."""
+    if value is None:
+        return None
+    try:
+        return json.loads(value)
+    except json.JSONDecodeError as exc:
+        raise click.BadParameter(f"{option_name} must be valid JSON.") from exc
+
+
+def parse_json_object(value: str | None, option_name: str) -> dict[str, Any] | None:
+    """Parse a CLI option as a JSON object."""
+    parsed = parse_json_value(value, option_name)
+    if parsed is None:
+        return None
+    if not isinstance(parsed, dict):
+        raise click.BadParameter(f"{option_name} must be a JSON object.")
+    return parsed
+
+
+def parse_json_array(value: str | None, option_name: str) -> list[Any] | None:
+    """Parse a CLI option as a JSON array."""
+    parsed = parse_json_value(value, option_name)
+    if parsed is None:
+        return None
+    if not isinstance(parsed, list):
+        raise click.BadParameter(f"{option_name} must be a JSON array.")
+    return parsed
+
+
+def parse_json_or_string(value: str | None, option_name: str) -> Any:
+    """Parse JSON when possible, otherwise keep plain strings."""
+    if value is None:
+        return None
+    stripped = value.strip()
+    if stripped.startswith("{") or stripped.startswith("["):
+        return parse_json_value(value, option_name)
+    return value

openai_pro_cli-2026.8.11.0/openai_cli/commands/chat.py

@@ -0,0 +1,301 @@
+"""Chat completion command."""
+
+import click
+
+from openai_cli.commands._json import (
+    parse_json_array,
+    parse_json_object,
+    parse_json_or_string,
+)
+from openai_cli.core.client import get_client
+from openai_cli.core.exceptions import OpenAIError
+from openai_cli.core.output import (
+    CHAT_MODELS,
+    DEFAULT_CHAT_MODEL,
+    print_chat_result,
+    print_error,
+    print_json,
+)
+
+
+@click.command()
+@click.argument("prompt")
+@click.option(
+    "-m",
+    "--model",
+    type=click.Choice(CHAT_MODELS),
+    default=DEFAULT_CHAT_MODEL,
+    show_default=True,
+    help="Model to use for chat completion.",
+)
+@click.option(
+    "-s",
+    "--system",
+    default=None,
+    help="System prompt to set the assistant's behavior.",
+)
+@click.option(
+    "--temperature",
+    default=None,
+    type=float,
+    help="Sampling temperature (0-2). Higher values = more random.",
+)
+@click.option(
+    "--max-tokens",
+    default=None,
+    type=int,
+    help="Maximum number of tokens to generate.",
+)
+@click.option(
+    "--max-completion-tokens",
+    default=None,
+    type=int,
+    help="Upper bound for tokens generated in a completion (including reasoning tokens).",
+)
+@click.option(
+    "-n",
+    "--count",
+    default=None,
+    type=int,
+    help="Number of completion choices to generate.",
+)
+@click.option(
+    "--top-p",
+    default=None,
+    type=float,
+    help="Nucleus sampling probability mass (0-1). Alternative to temperature.",
+)
+@click.option(
+    "--frequency-penalty",
+    default=None,
+    type=float,
+    help="Penalize tokens by their frequency in the text so far (-2.0 to 2.0).",
+)
+@click.option(
+    "--presence-penalty",
+    default=None,
+    type=float,
+    help="Penalize tokens that have already appeared in the text (-2.0 to 2.0).",
+)
+@click.option(
+    "--seed",
+    default=None,
+    type=int,
+    help="Seed for deterministic sampling.",
+)
+@click.option(
+    "--stop",
+    default=None,
+    multiple=True,
+    help="Stop sequence(s) where the API will stop generating (repeatable, up to 4).",
+)
+@click.option(
+    "--reasoning-effort",
+    type=click.Choice(["minimal", "low", "medium", "high"]),
+    default=None,
+    help="Reasoning effort for o1/o3/o4/gpt-5 series models.",
+)
+@click.option(
+    "--user",
+    default=None,
+    help="Unique end-user identifier for monitoring and abuse detection.",
+)
+@click.option(
+    "--service-tier",
+    type=click.Choice(["auto", "default", "flex", "scale", "priority"]),
+    default=None,
+    help="Processing type for serving the request (auto, default, flex, scale, priority).",
+)
+@click.option(
+    "--store",
+    is_flag=True,
+    default=False,
+    help="Store the output for use in OpenAI's model distillation or evals products.",
+)
+@click.option(
+    "--logprobs",
+    is_flag=True,
+    default=False,
+    help="Return log probabilities of the output tokens.",
+)
+@click.option(
+    "--top-logprobs",
+    default=None,
+    type=click.IntRange(0, 20),
+    help="Number of most likely tokens (0-20) to return at each token position with log probabilities.",
+)
+@click.option(
+    "--parallel-tool-calls",
+    "parallel_tool_calls",
+    flag_value=True,
+    default=None,
+    help="Enable parallel function calling during tool use.",
+)
+@click.option(
+    "--no-parallel-tool-calls",
+    "parallel_tool_calls",
+    flag_value=False,
+    help="Disable parallel function calling during tool use.",
+)
+@click.option(
+    "--stream", is_flag=True, default=False, help="Stream partial chat completion events."
+)
+@click.option(
+    "--response-format",
+    default=None,
+    help='Response format as JSON (e.g. \'{"type": "json_schema", "json_schema": {...}}\').',
+)
+@click.option(
+    "--tools",
+    default=None,
+    help='Tool definitions as a JSON array (e.g. \'[{"type":"function","function":{...}}]\').',
+)
+@click.option(
+    "--tool-choice",
+    default=None,
+    help='Tool selection mode or JSON object (e.g. "auto" or \'{"type":"function","function":{"name":"lookup"}}\').',
+)
+@click.option(
+    "--stream-options",
+    default=None,
+    help="Streaming options as a JSON object (e.g. '{\"include_usage\": true}').",
+)
+@click.option(
+    "--metadata",
+    default=None,
+    help="Metadata as a JSON object.",
+)
+@click.option(
+    "--logit-bias",
+    default=None,
+    help="Logit bias map as a JSON object.",
+)
+@click.option(
+    "--modalities",
+    default=None,
+    help="Requested modalities as a JSON array.",
+)
+@click.option(
+    "--audio",
+    default=None,
+    help="Audio output settings as a JSON object.",
+)
+@click.option(
+    "--prediction",
+    default=None,
+    help="Prediction settings as a JSON object.",
+)
+@click.option(
+    "--web-search-options",
+    default=None,
+    help="Web search settings as a JSON object.",
+)
+@click.option("--json", "output_json", is_flag=True, help="Output raw JSON.")
+@click.pass_context
+def chat(
+    ctx: click.Context,
+    prompt: str,
+    model: str,
+    system: str | None,
+    temperature: float | None,
+    max_tokens: int | None,
+    max_completion_tokens: int | None,
+    count: int | None,
+    top_p: float | None,
+    frequency_penalty: float | None,
+    presence_penalty: float | None,
+    seed: int | None,
+    stop: tuple[str, ...],
+    reasoning_effort: str | None,
+    user: str | None,
+    service_tier: str | None,
+    store: bool,
+    logprobs: bool,
+    top_logprobs: int | None,
+    parallel_tool_calls: bool | None,
+    stream: bool,
+    response_format: str | None,
+    tools: str | None,
+    tool_choice: str | None,
+    stream_options: str | None,
+    metadata: str | None,
+    logit_bias: str | None,
+    modalities: str | None,
+    audio: str | None,
+    prediction: str | None,
+    web_search_options: str | None,
+    output_json: bool,
+) -> None:
+    """Chat with an OpenAI-compatible model.
+
+    PROMPT is the user message to send to the model.
+
+    \b
+    Examples:
+      openai-cli chat "What is the capital of France?"
+      openai-cli chat "Explain quantum computing" -m gpt-5.4
+      openai-cli chat "Write a poem" -m gpt-4o --temperature 0.9
+      openai-cli chat "Summarize this" -s "You are a concise summarizer"
+      openai-cli chat "Reason about this" -m o3 --reasoning-effort high
+    """
+    client = get_client(ctx.obj.get("token"))
+    messages = []
+    if system:
+        messages.append({"role": "system", "content": system})
+    messages.append({"role": "user", "content": prompt})
+
+    try:
+        parsed_response_format = parse_json_object(response_format, "--response-format")
+        parsed_tools = parse_json_array(tools, "--tools")
+        parsed_tool_choice = parse_json_or_string(tool_choice, "--tool-choice")
+        parsed_stream_options = parse_json_object(stream_options, "--stream-options")
+        parsed_metadata = parse_json_object(metadata, "--metadata")
+        parsed_logit_bias = parse_json_object(logit_bias, "--logit-bias")
+        parsed_modalities = parse_json_array(modalities, "--modalities")
+        parsed_audio = parse_json_object(audio, "--audio")
+        parsed_prediction = parse_json_object(prediction, "--prediction")
+        parsed_web_search_options = parse_json_object(web_search_options, "--web-search-options")
+    except click.BadParameter as e:
+        print_error(e.format_message())
+        raise SystemExit(1) from None
+    payload: dict[str, object] = {
+        "model": model,
+        "messages": messages,
+        "stream": stream or None,
+        "temperature": temperature,
+        "max_tokens": max_tokens,
+        "max_completion_tokens": max_completion_tokens,
+        "n": count,
+        "response_format": parsed_response_format,
+        "tools": parsed_tools,
+        "tool_choice": parsed_tool_choice,
+        "top_p": top_p,
+        "frequency_penalty": frequency_penalty,
+        "presence_penalty": presence_penalty,
+        "seed": seed,
+        "stop": list(stop) if stop else None,
+        "stream_options": parsed_stream_options,
+        "reasoning_effort": reasoning_effort,
+        "user": user,
+        "service_tier": service_tier,
+        "store": store if store else None,
+        "metadata": parsed_metadata,
+        "logit_bias": parsed_logit_bias,
+        "logprobs": logprobs if logprobs else None,
+        "top_logprobs": top_logprobs,
+        "parallel_tool_calls": parallel_tool_calls,
+        "modalities": parsed_modalities,
+        "audio": parsed_audio,
+        "prediction": parsed_prediction,
+        "web_search_options": parsed_web_search_options,
+    }
+
+    try:
+        result = client.chat_completions(**payload)  # type: ignore[arg-type]
+        if output_json:
+            print_json(result)
+        else:
+            print_chat_result(result)
+    except OpenAIError as e:
+        print_error(e.message)
+        raise SystemExit(1) from e