gen-ai-uselisted
Install: claude install-skill PicsArt/gen-ai-skills
# gen-ai CLI — Usage Guide
The `gen-ai` CLI generates AI images, videos, and audio from the terminal via the Picsart API.
## When to Use
_See the description above._
## Prerequisites
Picsart `gen-ai` CLI installed and authenticated (`gen-ai login`).
## How to Run
_Use the agent's `terminal` tool to invoke `gen-ai` commands as described in the Procedure below._
## Quick Reference
- **Auth:** `login`, `logout`, `whoami`
- **Generation:** `generate`, `remove-bg`, `change-bg`, `enhance`, `vectorize`, `redo`, `extend`
- **Models / pricing:** `models`, `models info`, `models compare`, `pricing`, `credits`, `validate`
- **Batch:** `batch run`, `batch status`, `batch resume`
- **Drive:** `upload`, `download`, `list`
- **Config:** `config get | set | list | keys | unset`
- **History:** `history`, `history last`, `history files`, `history clear`
- **Utilities:** `completion`, `update`
Run `gen-ai <command> --help` for full flag details, or see [references/FLAGS.md](references/FLAGS.md).
## Procedure
_See sections below for the detailed walkthrough._
## Pitfalls
- **Stale model ID** — using a name from memory that's been renamed/removed → run `gen-ai models` first or `gen-ai validate -m <id>`.
- **Passing `--image` to a non-i2v video model** — it's silently ignored, not auto-mapped. Confirm with `gen-ai models info <id>`.
- **Forgetting `--no-input` in CI** — the CLI sits waiting for an interactive prompt and the job times out. Always pair `--script` (or `--no-input`) with