A command-line tool for OpenAI-compatible APIs via AceDataCloud.
pip install openai-pro-cliSign up at https://platform.acedata.cloud and get your API token.
export ACEDATACLOUD_API_TOKEN=your_token_hereOr save it to a .env file:
cp .env.example .env
# Edit .env and set ACEDATACLOUD_API_TOKEN# 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| 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 |
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.
| 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 compose run --rm openai-cli chat "Hello!" -m gpt-4o