Commands

Auth

gt auth login     # authenticate via browser (RFC 8628 device flow)
gt auth status    # show masked key, active org, and credit balance
gt auth logout    # revoke the API key and clear local credentials

Generate

gt generate image \
  -m <model> \
  -p "<prompt>" \
  [-a <aspect-ratio>] \
  [-r <resolution>] \
  [-o <output-path>] \
  [--reference <url> ...] \
  [--param key=value ...] \
  [--no-download]

Flag	Description
`-m`, `--model`	Model identifier or fuzzy name. Run `gt models list` to discover.
`-p`, `--prompt`	Generation prompt (required)
`-a`, `--aspect-ratio`	e.g. `16:9`, `1:1`, `4:3`, `9:16`
`-r`, `--resolution`	e.g. `1k`, `2k`, `4k`
`-o`	Output file path (default: `./goodtake-output/<id>.<ext>`)
`--reference <url>`	Hosted image URL for reference / editing. Repeatable.
`--param key=value`	Model-specific param (repeatable). Unknown keys return an error listing valid keys.
`--no-download`	Print the output URL only; skip downloading the file.

If a generation takes longer than 5 minutes the CLI stops waiting. Retrieve it later with gt generations get <id>.

Examples

# Default model (server picks, typically gpt-image-2)
gt generate image -p "a product shot of white sneakers on marble"

# Specific model + widescreen aspect ratio
gt generate image -m seedream-4-5-251128 -p "aurora borealis" -a 16:9

# Multiple images via model param
gt generate image -m gpt-image-2 -p "abstract watercolor" --param num_images=4

# Image-to-image editing
gt generate image -m gpt-image-2 -p "add dramatic storm clouds" \
  --reference https://example.com/landscape.jpg

# Print URL only
gt generate image -p "logo concept" --no-download

Generations

gt generations list [--limit 20] [--offset 0]   # list newest first
gt generations get <id>                          # status + output URL
gt generations download <id> [-o <path>]         # save output to disk

Models & Account

gt models list [--type image]    # identifier, name, provider, cost
gt account balance               # live credit balance
gt account topup --credits <n>   # open Stripe checkout in your browser

Update

gt update            # update to latest version
gt update --check    # check if a newer version exists without installing

gt update calls npm install -g @goodtake/cli@latest. If you installed via a different package manager, use that instead (e.g. pnpm add -g @goodtake/cli@latest).

Configuration

Credentials are stored in ~/.goodtake/config.json (mode 0600).

Exit codes

Code	Meaning
`0`	Success
`1`	Runtime error
`2`	Usage error

Commands

On this page