A command-line tool for AI image generation and editing using Flux through the AceDataCloud platform.
- Text-to-Image Generation — Generate images from text prompts with multiple Flux models
- Image Editing — Edit existing images using text descriptions (kontext models)
- Task Management — Query status, batch check, and poll for completion
- Multiple Models — flux-dev, flux-pro, flux-pro-1.1, flux-pro-1.1-ultra, flux-kontext-pro, flux-kontext-max
- Rich Output — Beautiful terminal formatting with
--jsonfor scripting
pip install flux-pro-cli# Set your API token
export ACEDATACLOUD_API_TOKEN=your_token_here
# Generate an image
flux generate "A majestic mountain landscape at golden hour, photorealistic"
# Generate with a specific model
flux generate "Cyberpunk city with neon lights" -m flux-pro-1.1
# Generate with aspect ratio (ultra/kontext models)
flux generate "Minimalist logo of a phoenix" -m flux-pro-1.1-ultra -s 16:9
# Edit an existing image
flux edit "Add sunglasses to the person" --image-url https://example.com/photo.jpg
# Edit with max context model
flux edit "Change background to sunset beach" --image-url https://example.com/img.png -m flux-kontext-max
# Check task status
flux task abc123-def456
# Wait for task completion
flux wait abc123 --interval 5 --timeout 300
# Batch check multiple tasks
flux tasks task-1 task-2 task-3| Command | Description |
|---|---|
generate |
Generate an image from a text prompt |
edit |
Edit an existing image with a text prompt |
task |
Query a single task status |
tasks |
Query multiple tasks at once |
wait |
Wait for a task to complete |
models |
List available Flux models |
aspect-ratios |
List available aspect ratios |
config |
Show current configuration |
| Model | Type | Size Input | Notes |
|---|---|---|---|
flux-dev |
Dev | Pixels | Fast, good balance (default) |
flux-pro |
Pro | Pixels | Higher quality |
flux-pro-1.1 |
Pro | Pixels | Better prompt following |
flux-pro-1.1-ultra |
Ultra | Aspect ratio | Highest quality |
flux-kontext-pro |
Kontext | Aspect ratio | Best for editing/style transfer |
flux-kontext-max |
Kontext | Aspect ratio | Max context for complex edits |
All commands support --json for machine-readable output:
flux generate "A red car" --json | jq '.task_id'
flux task abc123 --json | jq '.data[0].image_url'| Environment Variable | Description | Default |
|---|---|---|
ACEDATACLOUD_API_TOKEN |
API authentication token | (required) |
ACEDATACLOUD_API_BASE_URL |
API base URL | https://api.acedata.cloud |
FLUX_REQUEST_TIMEOUT |
Request timeout in seconds | 1800 |
You can also use a .env file or pass --token directly.
docker compose run flux-cli generate "A beautiful sunset"# Install with dev dependencies
pip install -e ".[all]"
# Run tests
pytest
# Run linter
ruff check .
ruff format --check .MIT License - see LICENSE for details.