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.4.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.4.0
File Size Uploaded
openai_pro_cli-2026.10.4.0.tar.gz 26.9 kB Details

Built distribution (wheel)

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

Total release size: 54.2 kB

Release files / openai_pro_cli-2026.10.4.0.tar.gz

Download URL openai_pro_cli-2026.10.4.0.tar.gz
Size 26.9 kB
Tags Source
SHA-256 checksum
How to use checksums
d2e3cae22112a929dc1df8eaec3320acde1f985b0a50c77d191cf6f00589bfad
BLAKE2b-256 checksum
How to use checksums
692684af246c0160966fb9a26c3ba850f3b0946a12fa504e30a87b10c4e8d980
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.4.0-py3-none-any.whl

Download URL openai_pro_cli-2026.10.4.0-py3-none-any.whl
Size 27.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3519de5a5c7f29f4902c65dfbb08d0308aa171b6992e24430f99ad80aaba2f5f
BLAKE2b-256 checksum
How to use checksums
a8e1b204918e479ae9a75ce967a4366bbd836ce8d4f503ab8c255bdccbff6e8c
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