civitai-gen

# civitai-gen Unified CLI for Civitai's orchestration Workflow API. All generation types share the same workflow lifecycle: submit, poll, download. ## Setup Requires Node.js 18+. Set `CIVITAI_API_KEY` either as an environment variable or in a `.env` file in this skill's directory (next to `generate.mjs`). Copy `.env.example` to `.env` to start. Get a key at: https://civitai.com/user/account > Paths below are relative to this skill's directory. Run the scripts from there (`cd` into it), or prefix with the install path your runtime uses. ## Capabilities | Command | What it does | Details | |---------|-------------|---------| | `wait` | Submit + poll + download (default) | All-in-one blocking generation | | `submit` | Fire-and-forget, returns workflow ID | For async workflows | | `status` | Check workflow progress | `--poll` for live updates | | `download` | Fetch completed media | From a workflow ID | | `cost` | Dry-run buzz estimation | `whatif=true`, 0 buzz spent | | `engines` | List video engines + live status | 11+ engines | | `tts` | Text-to-speech | See `docs/tts.md` | | `music` | Music/song generation (ACE Step 1.5) | See `docs/music.md` | | `transcribe` | Speech-to-text transcription | See `docs/transcription.md` | ## Quick Examples ```bash # Image (defaults to Flux.1, 4 images) node generate.mjs wait --prompt "A knight at sunset" -o ./out # Multiple concurrent prompts node generate.mjs wait --prompt "A warrior" --prompt "A mage" -o ./out # Video (VEO 3) node ...