Velin Motion Clips 1.3.0

Clip Motion turns still images into short motion clips via the CLI. Separate from Page Motion (DOM registry / velin-motion attributes). Package @birdapi/velinstyle-motion. Deutsch

Version history

1 releasesv1.3.0

Image→clip pipeline via `@birdapi/velinstyle-motion` (local + optional PixVerse).

1.3.0NewMotion Clips

Local clip engine, presets, CLI wizard, PixVerse provider, `.velin/motion/` config; empty/wrong-type input validation.

Install motion package; never commit PixVerse keys. Empty / non-image inputs are rejected before processing.

Changelog Upgrading

Local vs AI

	Local (default)	AI
Engine	CSS / Web Animations HTML	Provider API (PixVerse first)
Cost	Free, offline	Credits + API key
Output	`.html` + `.css` clip	MP4 (or dry-run manifest)
Reproducible	Yes	Depends on provider/seed

Quick start

# Interactive wizard
velinstyle motion create atelier.webp

# Non-interactive
velinstyle motion create hero.png --preset cinematic --yes -o ./motion-output

# Shortcuts
velinstyle motion zoom logo.png --yes
velinstyle motion pan shot.webp --duration 5 --yes

# Clip presets
velinstyle motion presets --clips

Input rules: files must exist, be non-empty, use .webp / .png / .jpg / .jpeg, and contain a real PNG/JPEG/WebP payload (empty files and renamed text are rejected).

create without --yes opens a TTY wizard: Soft Zoom / Cinematic / Atelier Reveal / Rotate / Particle Reveal / Rotate + Explosion / AI Animation / custom mini-prompt → confirm → write clip.

Mini-prompts

velinstyle motion create atelier.webp --ai
# Was soll passieren?
# > rechts rein

VelinStyle suggests structured profiles and translates them to a motion profile / AI prompt template. You do not write raw PixVerse prompts.

Atelier

velinstyle motion atelier ./assets --count 10 --preset atelier --yes

Processes N images → clips under ./motion-output/ with a summary (count · total seconds).

Transition & sequence

velinstyle motion transition a.webp b.webp --yes
velinstyle motion sequence 01.webp 02.webp 03.webp --provider pixverse --yes

AI path uses provider capabilities (transition, multi_transition, 2–7 keyframes). Without a key, use motion setup pixverse (TTY) or set PIXVERSE_API_KEY. With --yes and no key → exit 1. Dry-run only via VELIN_MOTION_DRY_RUN=1.

Config

Created under .velin/motion/ (config.json, .env, presets/, jobs/, cache/):

{
  "provider": "pixverse",
  "api_key": "${PIXVERSE_API_KEY}",
  "model": "v6",
  "quality": "720p",
  "default_duration": 5,
  "output_dir": "./motion-output",
  "pixverse": { "setup_completed": false }
}

Never put a plaintext API key in config.json. Use env PIXVERSE_API_KEY or .velin/motion/.env. Keys are never logged, printed in --json, or written to manifests.

Detailed partner guide: PixVerse setup.

PixVerse setup

AI animations are produced by external providers. PixVerse is a supported partner provider — not a VelinStyle core feature. Branding: VelinStyle Motion · AI Provider: PixVerse.

velinstyle motion providers
velinstyle motion setup pixverse

CLI: velinstyle motion setup pixverse — menu: open PixVerse account · copy account link · enter API key
Create a key in your PixVerse account
Paste key — save to .velin/motion/.env when prompted
Run velinstyle motion create image.webp --ai --yes

If the partner link cannot open (tracker/cookie blocker), the CLI offers retry or copy link — not a direct platform bypass. Full guide: PixVerse setup.

Each live request sends API-KEY + auto-generated Ai-trace-id (UUID). Docs: docs.platform.pixverse.ai.

Usage

velinstyle motion usage

Shows today / week clip counts and a PixVerse credit hint from local job manifests.

Velin Motion (Page) · CLI reference