Skip to main content

​
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

An auth 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

A usage 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

A quota 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

A timeout 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

A network 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.
See Scripting and agents for the full exit code table and machine-readable error envelopes.