Command not found
Add the install directory to your current shell path.Login does not open a browser
Print the authorization URL and open it manually.Saved key is missing
Check the active profile and log in again if the profile has no key.Authentication failed
Anauth error, exit code 3, means the active profile has no key, or its key is missing, expired, or does not match the profile’s API environment. Confirm the resolved base URL and key source, then log in again or set a key for the right environment.
Usage error in scripts
Ausage error, exit code 2, in non-interactive or JSON runs usually means the command needed input a prompt would normally collect. The common cases: breeze tts needs --voice or --random-voice, and destructive commands such as voice delete, history delete, and cache clean need --yes.
Not enough credits
Aquota error, exit code 4, means the account balance is too low for the request. Check the balance and top up before retrying.
Request timed out
Atimeout error, exit code 5, means the request did not finish within the timeout window. Raise --timeout for slow networks or large generations, then retry.
Network or upstream failure
Anetwork error, exit code 6, covers connection failures and temporary upstream errors, including upstream 5xx responses. These are usually transient. Confirm connectivity and retry after a short wait. The same code is returned when breeze update cannot reach the release manifest.
Update fails
breeze update --check returns a network error, exit code 6, when the release manifest is unreachable. Confirm network access and retry. The manifest URL can be overridden with --manifest-url for internal or pinned channels.
Video Lab dependencies
Doctor reports missing local tools before rendering. It runs these local checks without a Breeze login or credits. Install the missing dependency, then rerun doctor.Video Lab projects
Unsupported Video Lab project version, Unsupported Video Lab script version or No Video Lab project at … means the directory is not a Video Lab project. Create one with breeze video init --project <dir> --agent.
Prepared audio is stale or Composition is stale means the script, timeline or project files changed since the last run. Rerun breeze video audio (cached takes are reused) or breeze video compose. See Video Lab.
See Scripting and agents for the full exit code table and machine-readable error envelopes.
