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 |
Embedding models
embed supports text-embedding-3-small (the default) and text-embedding-3-large. The legacy text-embedding-ada-002 model is retired. When migrating an existing index, regenerate its vectors and rebuild the index; do not mix vectors from the old and new models.
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
1 maintainer
Metadata
1 maintainer
Release files for openai-pro-cli 2026.10.5.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| openai_pro_cli-2026.10.5.1.tar.gz | 27.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| openai_pro_cli-2026.10.5.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 54.5 kB
Release files / openai_pro_cli-2026.10.5.1.tar.gz
| Download URL | openai_pro_cli-2026.10.5.1.tar.gz |
|---|---|
| Size | 27.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
57f87892f7d76c7029151f50879024b50ef3e19d0ac9af00bf02297c5a000a37
|
|
BLAKE2b-256 checksum How to use checksums |
a2f8b48ea7e487d3390c37086613ca03cb8f2c7dfee4d1af088388ffef5b0d5a
|
| 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.1-py3-none-any.whl
| Download URL | openai_pro_cli-2026.10.5.1-py3-none-any.whl |
|---|---|
| Size | 27.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9a7fb475239289dcd4a1f32c97341d7b1ef8bce6f003f5d396391bdbb959940a
|
|
BLAKE2b-256 checksum How to use checksums |
bdd60df2d7048c4abdd5e8805b0fb11169c1e86f718ef9660ca2ac1dfd41004b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
