Ducklygen CLI

Run any Ducklygen model from your terminal or a coding agent. Every render is priced before it starts and drawn from the same balance as the studio.

Coming soonThe @ducklygen/cli package is not published yet. The commands below show how it will work.

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.
  1. 1

    The CLI is coming soon

    The command-line tool is not published yet. Until it is, everything runs in the studio.

    npm i -g @ducklygen/cli
  2. 2

    Create an API key

    Sign in with your email, open Settings, API keys and create a key. Top up from €3 in Billing.

    ducklygen login
ducklygen whoami
  3. 3

    Make your first render

    Pick a model ID from the catalog and send a prompt. Add --dry-run to see the price without spending anything.

    ducklygen models --type image
ducklygen run <model> -p "duck on teal waves" --dry-run
ducklygen run <model> -p "duck on teal waves" -o ./out/

Command

ducklygen loginPaste your API key once; it is checked and saved
ducklygen whoamiThe key's name and your balance
ducklygen models --type videoEvery video model with its starting price
ducklygen run <model> -hA model's fields, fetched live: type, default, allowed values
ducklygen run <model> -p "<prompt>" -o ./out/Render and save the result in a folder
ducklygen run <model> -p "..." --dry-runThe exact price, without spending anything
ducklygen run <model> -p "..." --max-price 0.50Refuse to run if the price is higher
ducklygen run <model> -p "..." --json -o ./out/One JSON result, ready for the next step
ducklygen skill installTeach your coding agent to use the CLI
Developers →