AdSkull CLI
AdSkull CLI · v0.1

Generate ads from your terminal.
Images. Videos. Voices. Avatars.

The official AdSkull command-line interface. Same models as the dashboard — wired into your shell, your scripts, and your build pipelines.

$ curl -fsSL https://cli.adskull.io/install.sh | sh
$ npm install -g @adskull/cli

Requires Node.js 18+. Linux, macOS, Windows. Get an API key at app.adskull.io/api.

One install, every model

Run any AdSkull image, video, voice, or avatar model with a single command.

Streaming results

Jobs poll automatically. Download finished assets straight to disk with -o.

Script-friendly

--json mode for scripting. Pipe into jq, ffmpeg, or CI.

Quickstart

From zero to a generated video in 60 seconds.

Install, log in once, run anything. The CLI handles polling, retries, and asset downloads for you. 

# 1. Install
$ curl -fsSL https://cli.adskull.io/install.sh | sh

# 2. Authenticate (one time)
$ adskull login sk_live_...

# 3. Make something
$ adskull images generate \
    -p "hyperrealistic product shot of a glowing energy drink can" \
    -m nano-banana-pro -r 1:1 -o can.png

# 4. Animate it
$ URL=$(adskull assets upload ./can.png --json | jq -r .url)
$ adskull videos generate \
    -p "slow rotating product shot, studio lighting" \
    -m wan-2-5 --image "$URL" --duration 5 -o can.mp4

Commands

Everything you can do.

adskull images generate

Text-to-image across every supported model with reference image support.

adskull videos generate / extend

Text-to-video, image-to-video, or extend an existing clip.

adskull voice generate

TTS or speech-to-speech with any built-in or custom voice.

adskull voice clone / design

Clone a voice from audio, or design a new one from a description.

adskull avatar generate

Lipsync any portrait to a script or an existing audio file.

adskull assets upload

Host a local image, audio, or video file. Returns a URL the API can read.

adskull models / voices / pricing

Browse the live catalog. Filter with --type.

adskull webhooks create / list

Wire job-completed events into your stack.

adskull jobs status

Re-check or resume a previously created job by ID.

adskull whoami / usage

Inspect your plan, remaining credits, and current period usage.

Auth

One API key. Three ways to use it.

# Saved to ~/.adskull/config.json
$ adskull login sk_live_...

# Or as an environment variable
$ export ADSKULL_API_KEY=sk_live_...

# Or inline per call
$ adskull images generate -p "..." --api-key sk_live_...