Infimal CLI reference
One native binary for the terminal dashboard and scriptable account commands.
Start here
Install from /cli/, create a key in the dashboard, and connect with the hidden prompt. Bare infimal opens the dashboard in an interactive terminal. Explicit commands remain scriptable.
infimal login --key
infimal
infimal guide
infimal --helpModels & account
| Command | Purpose |
|---|---|
| infimal models list --json | List models and actual prices |
| infimal models show MODEL_ID --json | Inspect a model |
| infimal whoami | Verify credentials and API origin |
| infimal usage show --since 30d --json | Inspect usage |
| infimal usage series --since 72h --bucket hour | Read a usage series |
| infimal requests list | Inspect recent requests |
Applications
plan, apply and deploy run your Python module through the SDK; deploy --file and config send a JSON request file without it.
infimal apps plan MODULE
infimal apps apply MODULE
infimal apps deploy MODULE
infimal apps deploy --app APP_NAME --file request.json --plan
infimal apps list
infimal apps show APP_NAME
infimal apps config APP_NAME --file configuration.json
infimal apps logs APP_NAME --limit 50
infimal builds show BUILD_IDImages and video
A generation is a job: the submit holds the credit and answers with an id. --wait polls until the job finishes and exits 1 if it failed. Artifact links expire; download reads the job again for fresh ones.
infimal jobs submit --surface images --model MODEL_ID --preset I1 --prompt "a paper boat" --wait
infimal jobs get JOB_ID
infimal jobs list
infimal jobs download JOB_ID ./outBilling
Funding returns a checkout link; finish payment in your browser. A local plan sends no request and is not a server quote. After an interrupted checkout, inspect payments before retrying.
infimal billing balance
infimal billing fund 25 --plan
infimal billing fund 25 --wait
infimal billing paymentsKeys
A full key manages the account. An inference key is restricted to inference, the catalogue and its allowed usage reads. Newly created secrets are returned once.
infimal keys create production --role inference
infimal keys list --json
infimal keys revoke KEY_IDAutomation
Use --json for machine-readable responses. Remote commands accept --plan for a local redacted preview without an HTTP request. Exit codes are 0 success, 1 API refusal, 2 local input/configuration, 3 transport/server/I/O, and 4 credentials.
infimal explain apps deploy
infimal manifest --json
infimal completion zsh
infimal logout