cli

beatapi

Official BeatAPI command-line interface for people, scripts, and AI agents.

npm install --global beatapi
beatapi auth login
beatapi workflows list

The login command validates the key before storing it in the operating system's credential manager. For CI and short-lived shells, set BEATAPI_API_KEY instead.

beatapi music-video create --file music-video.json
beatapi tasks wait task_123 --interval 7000
beatapi realtime sessions create --duration 60 \
  --origin https://app.example.com \
  --idempotency-key rt_checkout_123

Results are JSON on stdout. Progress and errors use stderr so the CLI composes cleanly with shell scripts and automation tools.

Webhook creation writes the one-time signing secret to a mode-0600 file and returns its path as secret_file; it does not print the secret.

Realtime session creation prints the API result, including its one-time, short-lived client_secret. Run it only in a trusted terminal, avoid CI log capture, pass only that secret to the browser SDK, and never expose an sk_ API key in browser code.

See the repository for the complete command reference and security model.