Skip to main content

OpenAI CLI

A command-line tool for OpenAI-compatible APIs via AceDataCloud.

Installation

pip install openai-pro-cli

Quick Start

1. Get an API Token

Sign up at https://platform.acedata.cloud and get your API token.

2. Configure

export ACEDATACLOUD_API_TOKEN=your_token_here

Or save it to a .env file:

cp .env.example .env
# Edit .env and set ACEDATACLOUD_API_TOKEN

3. Use

# 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)
transcribe Audio transcription (/v1/audio/transcriptions)
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

docker compose run --rm openai-cli chat "Hello!" -m gpt-4o

Metadata

Release files for openai-pro-cli 2026.10.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for openai-pro-cli 2026.10.5.0
File Size Uploaded
openai_pro_cli-2026.10.5.0.tar.gz 26.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for openai-pro-cli 2026.10.5.0
File Interpreter ABI Platform
openai_pro_cli-2026.10.5.0-py3-none-any.whl Python 3 none any Details

Total release size: 54.3 kB

Release files / openai_pro_cli-2026.10.5.0.tar.gz

Download URL openai_pro_cli-2026.10.5.0.tar.gz
Size 26.9 kB
Tags Source
SHA-256 checksum
How to use checksums
b841bc63c1f0e03e95a96593cb29ec8427da0c8eca421f1f44a0f64f971e2f74
BLAKE2b-256 checksum
How to use checksums
2229be9a5892a356790601ee54897c704c9869be7c3d94be33b4c2b6bce42875
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / openai_pro_cli-2026.10.5.0-py3-none-any.whl

Download URL openai_pro_cli-2026.10.5.0-py3-none-any.whl
Size 27.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
342a1cb5c9d103e38a29e13c1aab6c69e7701feba39eef3a6fbef0e1c404fbe7
BLAKE2b-256 checksum
How to use checksums
bfdf8fa1dc5770ae967c17146dca7036707833b19150c2c34583b506fed84406
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page