cli.

Run any model from a shell, a CI job or a coding agent. Every render is priced before it starts and drawn from the same balance.

Install the CLI
$ npm i -g pufy-io
CLI

Render from the terminal

Run any model from a shell, a CI job or a coding agent. Every render is priced before it starts and drawn from the same balance.

Scripts and CIEvery field of a model is a flag; a local file is uploaded for you.
JSON on stdoutOne JSON document per run, progress and errors on stderr, a non-zero exit on failure.
Coding agentsA skill file teaches your agent to check the price first and cap it.
CommandWhat it does
pufy loginPaste your API key once; it is checked and saved
pufy whoamiThe key's name and your balance
pufy models --type videoEvery video model with its starting price
pufy run <model> -hA model's fields, fetched live: type, default, allowed values
pufy run <model> -p "<prompt>" -o ./out/Render and save the result in a folder
pufy run <model> -p "..." --dry-runThe exact price, without spending anything
pufy run <model> -p "..." --max-price 0.50Refuse to run if the price is higher
pufy run <model> -p "..." --json -o ./out/One JSON result, ready for the next step
pufy skill installTeach your coding agent to use the CLI
Quickstart

First render in three steps

  1. 1Create an API keyIn Settings > API keys, name a key and copy it once. Top up from €3 in Billing.export PUFY_API_KEY="YOUR_API_KEY"
  2. 2Install the CLIThe pufy command-line tool installs with npm, pnpm or bun.npm i -g pufy-io
  3. 3Make your first renderPick a model ID from the catalog and send a prompt. Add --dry-run to see the price without spending anything.pufy run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/